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Chapter 1 


Telephony Framework API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 
[2] 3GPP Specification References: 


3GPP TS 24.008 Mobile radio interface Layer 3 specification; Core network protocols; Stage 3 
(Release 5) 


3GPP TS 22.030 Man-Machine Interface (MMI) of the User Equipment (UE) (Release 5) 


3GPP TS 24.080 supplementary services specification (Release 5) 


3GPP TS 23.038 Alphabets and language-specific information (Release 5) 


3GPP TS 23.040 Technical realization of the Short Message Service (SMS) (Release 5) 


3GPP TS 29.002 Mobile Application Part (MAP) specification (Release 5) 


3GPP TS 31.102 Characteristics of the USIM application (Release 5) 


3GPP TS 22.084 MultiParty (MPTY) Supplementary Services - Stage 1 (Release 5) 


3GPP TS 23.014 Support of Dual Tone Multi Frequency (DTMF) signaling (Release 5) 


1.3 Overview 


This specification provides the LiMo OEM Adaptation Layer Plug-in API Specification. The document 
specifies how OEM Adaptation Layer Plug-in will interface with Telephony Server. 


This document provides OEM Telephony APIs and descriptions of the APIs for functionality related to 
following telephony services 


* Call Services 
* Supplementary Service 
* Unstructured Supplementary Data 


* Network Registration 


Telephony Framework API 


SIM 


SMS 


1.2.1 Definitions, Acronyms, and Abbreviations 


TAPI: Telephony API library is responsible for carrying Application (user) requests to Telephony 
Server for various telephony services. 


Telephony Server: It is a process which receives the Application requests from multiple applications 
for various telephony services. 


OEM Adaptation Layer: This layer hides the underlying wireless stack and its interface part.. This 
allows the flexibility to port any underlying modem according to vendor requirement or business 
model. This abstracts the inter process communication used for single processor / dual processor 
model. This layer is vendor implementation specific. 


OEM Adaptation Layer Plug-in APIs: Telephony Server will call OEM Adaptation Layer Plug- 
in APIs to serve for application requests for various telephony related services. Also Indica- 
tion/Response/Confirmation APIs are defined in this document which will be used by the OEM 
Adaptation layer in order to pass the responses/indications to Telephony Server. Telephony Server 
will generate events and publish it to application. 


1.2.2 Execution Model 


This specification provides the LiMo OEM Adaptation Layer Plug-in API Specification. Telephony Server 
uses OEM Adaptation Layer Plug-in APIs in order to pass the Telephony service requests to underlying 
wireless stack used by OEM Provider. OEM Adaptation layer plug-in will be using Telephony server 
callback APIs to provide the confirmations/indications from OEM Telephony Provider. 
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1.2.2.1 Telephony Logical Architecture 


Application 1 Application 2 Application 3 


Telephony Framework 


Telephony Server 


Telephony Provider 


Figure 1.1: Telephony Logical Architecture 


1.2.3 Call Flows 


Telephony Server calls OEM Adaptation Layer Plug-in APIs to pass the requests received from TAPI to 
OEM Adaptation layer. OEM Adaptation layer is vendor specific plug-in implementation. OEM Adapta- 
tion layer will provide the requests to underlying wireless stack to get the actual service requested for. On 
receiving the response from OEM Telephony provider, OEM Adaptation Layer plug-in will call Telephony 
server callback APIs in order to pass the actual response to the Application. Telephony Server will generate 
events and publish it to the application using LiMo ED. Figure 2 explains the call flow for Telephony server 
and Oem Adaptation layer plug-in request and response scenario. There can be more than 1 asynchronous 
response to a single request, e.g. call setup. In case of call setup request, Telephony server will receive 
unsolicited indications such as call setup ind, call alert ind, connecting ind from the network. 
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OEM Adaptation Layer 
Telephony Server (Plug-in) 


OEM Adaptation Layer 
Plug-in АР 
TelOemXXXReq 


API Return 


Telephony Server АР! 


TelOemXXXCnf 
АР! Return 


Figure 1.2: Call Flow Explains Request and Response Scenario 


On receiving any Indications or notification from OEM Telephony provider, OEM Adaptation layer will 
call plug-in APIs. Telephony Server will generate events and associated data will be published to the 
Application using LiMo ED. Figure 3 explains the call flow for Telephony server and Oem Adaptation 
layer plug-in indication and response scenario. 


OEM Adaptation Layer 
Telephony Server (Plug-in) 


Telephony Server АР! 


ТеЮОетхххіпа 
АРІ Return 


OEM Adaptation Layer 
Plug-In API 


TelOemXXXResp 


API Return 


Figure 1.3: Call flow Explains Indication and Response Fcenario 


1.2.4 Roles of LiMo OEM Adaptation Layer Plugin 


OEM Adaptation Layer Plug-in APIs hides the implementation of OEM Adaptation layer interface of the 
underlying modem. The Telephony Server will call OEM Adaptation Layer Plug-in APIs in order to pass 
the telephony service requests to OEM Telephony provider. 


OEM Adaptation Layer Plug-in code will be written by vendor according to the interfaces defined by their 
underlying modem and its process model. 
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In order to pass the responses received for the requests or the indications from OEM Provider (wireless 
protocol stacks) to Telephony Server, Telephony Server function APIs will be called which in turn will 
generate events accordingly and publish it to the registered clients 


OEM Adaptation layer Plug-in will run in same process context of Telephony server. 


This allows the functionality of standard plug-in interface. 


1.25 General Programming Considerations 


1. 


10. 


11. 


OEM Adaptation layer Plug-in API calls should be non-blocking call. If it is a blocking call, then it 
will degrade the performance of Telephony Server. 


. As OEM Adaptation Layer is a plug-in, АП OEM Adaptation Layer Plug-in Request (Кед) APIs and 


Response (Rsp) APIs handling shall be implemented by Vendor. 


. OEM Adaptation layer has to call the appropriate Indications/Responses API(defined in Indica- 


tions/Responses Section of this document) provided by the Telephony Server in order to pass re- 
sponses/notification to the Application. 


. Return value of OEM Adaptation Layer plug-in Request API only implies whether request is sent 


successfully or not to the Oem Telephony provider. Return value success does not imply that the 
request functionality is fully executed. If return value indicates Failure, then no further processing 
of the request is done at OEM. 


. In case of failure( FALSE") return of any confirmation/indication API, OEM adaptation layer plug- 


in may perform further processing, if required. 


. All request Confirmations/Indications are sent asynchronously by calling the OEM Indica- 


tion/confirmation APIs. 


. For a Request API, corresponding confirmation API to be called by OEM Adaptation layer is self- 


explanatory by naming convention 


. Request. id is generated by telephony server and it is unique identifying the request made by TS 


and used for mapping the responses provided by the OEM Adaptation layer. The same Requestld is 
expected to be provided by OEM adaptation layer along with the confirmation. Request id provided 
to the OEM Adaptation Layer shall be a valid positive value. In case OEM Adaptation layer receives 
any value less than 0, it can send ТАРІ АРІ INVALID REQUEST 1 error back to TS. 


. The memory allocated for the data in a particular layer should be deallocated by the same layer once 


the APIs are returned successfully. 


OEM Adaptation layer plug-in shall throw an error ТАРІ АРІ REQUEST MAX ІМ PROGRESS 
for an API request as the maximum number of requests for the same service is already in progress at 
OEM Adaptation layer. 


Asynchronous confirmation APIs(Cnf APIs) and indication APIs (Ind APIs) may return false, if 
there is communication loss between TAPI Client and Telephony server. This API return is just an 
indication to OEM Adaptation layer that asynchronous response failed at TS. 


APIs follows convention of ending with Req, Rsp, Cnf and Ind. Description is provided for the 
convention in the following Table: 
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Number 


API Suffix Used 


Description 


1 


Кед 


Telephony Server make service 
requests by calling Req OEM 
Adaptation Layer Plug-in APIs 


Cnf 


Cnf API callbacks are used to 
provide asynchronous 
responses received from lower 
layers to Telephony Server. 


Ind 


Ind API Callbacks are used by 
the OEM Adaptation layer 
Plug-in to pass the network 
indications or lower layer 
indications to Telephony server. 
Based on the indications, TS 
will inform application by 
publishing events using LiMo 
ED. 


Rsp 


Using the Rsp APIs, response is 
sent to OEM Telephony 
provider when network 
interrogates UE for necessary 
information to provide the 
service. 


13 


None 


1.4 


None 


1.5 


Мопе 


1.6 


Мопе 


17 


Мопе 


Industry Standard 


External API Documents 


Plug-in Extension Point Interface 


Other Interfaces 


Other Notes 
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Module Index 


2.1 Modules 


Here is a list of all modules: 


СайбЅегутсеѕ P PPM "UL"---"-—— 15 
TelOemCallSetupReq .............:..:.......4......2..4:2-.. 17 
TelOemCalláànswerReq . . .... lere 19 
TelOemCallReleaseReq . . .... re 20 
TelOemCallSendDtmfReq ................................... 21 
TelOemCallRetrieveReq .................................... 22 
TelOemCallHoldReq >з nas з жшж ж жа 6 GS RO E Re RS жа» 23 
ТыиОетСаШошЕКед.-.2-....-...:........:..:.2..44.2%-...4.... 24 
TelOemCallSphtReq. ыы. eR жж жж жж жож жосу асасы ра жожо ылы А 25 
TelOemCallTransferReq .................................... 26 
TelOemCallSendDtmfCnf. ................................... 27 
ТеіОетСаШПбешрСағ.......................2............... 28 
ТеЮОепСаПЕеісавеСаҒ..................................... 29 
TelOemCallAnswerCnf ..................................... 30 
TelOemCallHoldCnf ...................................... 21 
TelOemCallRetrieveCnf. . . . o oa a a a a 32 
TelOemCallJoimCnf ....— 40x soo e xe oue еле 0x X9 ЫЛЕ зле x R9 аА А 33 
TelOemCallSphtCnf sm eee S EEG EUR ЕЗ Od oso E е аа 34 
ТеЮОегпСаПТтапвТеСаҒ..................................... 35 
TelOemCallIncomingInd .................................... 36 
TelOemCallAlertInd ...................................... 37 
ТеЮОепСаПСоппесееаШша.................................... 38 
TelOemCallConnectingInd ................................... 39 
TelOemCallEndInd ....................................... 40 
TelOemCallForwardInd ..................................... 41 
TelOemCallRetrieveInd ..................................... 42 
ТеЮОепСайНоіШпа....................................... 43 
TelOemCallTransferInd ..................................... 44 
TelOemCallJoinInd ....................................... 45 
TelOemCallWaitinglnd ................................. .... 46 
TelOemCallUserlnfolnd .................................... 47 

lb. "PT" BR eae. wae eS Bae eS ee Eee we ea 48 


TelOemImtReq 5: = Se dork etek кета ы бек ымы € Be ж ЫЛЕ ee 4 SOROR 49 


Module Index 


TelOemDelIntRéq « uuo] кк ey RO Re еже Re Re OS BOR E S ЕЕ 50 
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TelOemPhoneStatusInd ..................................... 53 
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TelOemTunnelCnE =. & edb PAD E uem veu SHEE wee uy 55 
TelOemTunnelInd |... uode кюу з кк кж» жю а Р ЕК RO Od OW m E SOR 56 
NetFextSeryicéSce seek кыж ж жшж A RO Soke жые БОК aie Eos ERNE SCR IRI AT 
TelOemSmsSendReq ...................................... 58 
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TelOemSmsWriteReq 2. ceos o o eoa a a a E E rs 61 
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TelOemSmsSetSCAReq .................................... 64 
TelOemSmsGetCountReq... 2... 2... llle 65 
TelOemSmsCBGetConfigReq ................................. 66 
Те Оет$т<СВ$еїСопһ;Кец.................................. 67 
TelOemSmsGetPreferredBearerReq .............................. 68 
Те`Оет$т$еїРгеїетте@йВеагегКед............................... 69 
TelOemSmsSendDeliveryReportReq ............................. 70 
TelOemSmsSetParametersReq ................................. 72 
TelOemSmsGetParametersReq ................................. 73 
TelOemSmsSendCnf ......................2.2.2.2.2.... ........ 74 
TelOémSmsReadCnf 4423 казы GRR RUE ак ата ЖО ОЁ 76 
Те`Оет$т<СВСеїСопйг;Спї.................................. TI 
TelOemSmsGetParametersCnf ................................. 79 
TelOemSmsDeleteCnf ..................................... 80 
TelOémSmsWrteCnE ook в а араа Rok € x ЕО өзе EUR Sw 4 ша“ Б 81 
TelOemSmsSendDeliveryReportCnf .............................. 82 
Те`Оет$т$еїРгеїеттейВеагегСпЁ............................... 83 
TelOemSmsSetSCACnf > ..... жшж ж жк сы езйн ККК ж жа кой КОЛЫ жос 84 
Те`Оет$т<СВ$еїСопһ;СпЁ.................................. 85 
TelOemSmsSetParametersCnf ................................. 86 
TelOemSmsGetPreferredBearerCnf .............................. 87 
TelOemSmsGetCountCnf . < o e e ere m ea E ........ 88 
TelOemSmsCBIncominglnd .................................. 90 
TelOemSmsIncomingInd .................................... val 
TelOemSmsMemoryStatusInd ................................. 92 
NGtWOrKSEnVICeS:. "Lc ed Soe Se RO ee Oe «оло ees 93 
TelOemNwSetConfigurationReq ................................ 94 
TelOemNwSelectNetworkReq ................................. 95 
TelOemNwSearchNetworkReq ................................. 96 
TelOemNwGetNetworkInfoReq ................................ 97 
TelOemNwSetSelectionModeReq ............................... 98 
TelOemNwGetSelecionModeReq ............................... 99 
TelOemNwCancelManualSearchReq .............................. 100 
TelOemNwCancelManualSelectionReq ............................ 101 
TelOemNwSetServiceDomainReq ............................... 102 
Те©ОетМуб$еїМеїуогКОгдегКед................................ 103 
Те ©етМуб$еїМеїуогКМодеКед................................ 104 
TelOemNwSetNetworkBandReq ............................... 105 
TelOemNwRadioInfoInd .................................... 106 
TelOemNwSearchNetworkInd ................................. 107 
TelOemNwChangedlInd . ........ re 108 
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TelOemNwSelectNetworkCnf ......... lees 109 
TelOemNwSearchNetworkCnf .2................................ 110 
TelOemNwGetSelectionModeCnf ............................... 111 
TelOemNwGetNetworkInfoCnf ................................ 112 
TelOemNwCancelManualSearchCnf .............................. 113 
TelOemNwCancelManualSelecionCnf . ............................ 114 
TelOemNwSetNetworkOrderCnf . ....... 22e 115 
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TelOemSimUnblockPINReq .................................. 125 
TelOemSimEnablePINReq ................................... 126 
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TelOemSimUpdateFileReq ................................... 130 
Те©Оет5тЕпаЬеЕОМКед................................... 131 
TelOemSimDisableFDNReq .................................. 132 
Те©ОетбїтСеїРЇМшїюКед................................... 133 
TelOemSimPbGetStorageCountReq .............................. 134 
TelOemSimPbGetEntryInfoReq ................................ 135 
TelOemSimPbReadRecordReq ................................ 136 
TelOemSimPbUpdateRecordReq ................................ 138 
TelOemSimPbDeleteRecordReq ................................ 139 
TelOemSimChangePINCnf ................................... 140 
TelOemSimVerifyPDINCnf . ... a 141 
TelOemSimUnblockPINCnf .2................................. 142 
TelOemSimEnablePINCnf ...................2....... .......... 143 
Те!Оега5іі ЫізаМеРІМСТ......................... .......... 144 
Те!Оегабіт Се ейштоСа................................... 145 
TelOemSimReadFileCnf .......................... .......... 146 
TelOemSimUpdateFileCnf ........................... ........ 147 
TelOemSimEnableFDNCnf . .................................. 148 
TelOemSimDisableFDNCnf .................................. 149 
TelOemSimGetPINInfoCnf ................................... 150 
TelOemSimPbGetStorageCountCnf .............................. ІЗ! 
TelOemSimPbGetEntryInfoCnf. ................................ 153 
TelOemSimPbReadRecordCnf ................................. 155 
TelOemSimPbUpdateRecordCnf ................................ 156 
TelOemSimPbDeleteRecordCnf ................................ 157 
TelOemSimCardStatusInd ................................... 158 
TelOemSimCardTypelnd .................................... 159 
ЭССЕ "i-em 160 
TelOemSsSetCallBarringReq .................................. 161 
TelOemSsChangeBarPasswordReq ............................... 163 
TelOemSsGetCallBarringStatusReq .............................. 164 
TelOemSsSetCallForwardReq ................................. 165 
TelOemSsGetCallForwardStatusReq ............................. 167 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


10 Module Index 
TelOemSsSetCallWaiingReq . .. re 168 
TelOemSsGetCallWaitingStatusReq .............................. 169 
TelOemSsSendUssdReq .................................... 170 
Те`Оет$5ОпегуСарааышушШоКед............................... 171 
TelOemSsSendUssdUserRsp .................................. 172 
TelOemSsVerifyBarPwdRsp .................................. 173 
TelOemSsSetCallBarringCnf ................................. 174 
TelOemSsChangeBarPasswordCnf ............................... 176 
TelOemSsGetCallBarringStatusCnf . .. noaa a 177 
Те1Оет585е(СаПЕогмагаСағ............................... ... 178 
TelOemSsGetCallForwardStatusCnf ............................. 180 
TelOemSsSetCallWaitingCnf .................................. 182 
TelOemSsGetCallWaitingStatusCnf ........................2....... 183 
TelOemSsSendUssdCnf . ....... ee 184 
TelOemSsUssdInd аара o m o E em e m dog o kh n 185 
TelOemSsQueryCapabilityInfoCnf ............................... 186 
TelOemSsGetPwdInd ...................................... 187 

Call Data:Strctures R-mus 188 
NetText Data Structures... . 22e 2... 195 
Network Data Structures ............................2.2..2..2........ 200 
SIM Data Structures... "D" ғы ға GS eee елі 4 ee Жо ОА 205 
SS DataStructutes «e xao езе жык рли лк dh moe geb OE БАЙ ж Ree iue om e e s ae em d 221 
Utility Data Structures. 252057225556 ете E RO и ыы E КЫ ЫЫ ee S 230 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Chapter 3 


Data Structure Index 


3.1 Data Structures 


Here are the data structures with brief descriptions: 
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41 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Doxy eD) ocu koe Ge eA лр ee ea dede ESS eee 32] 

OemTapiCall.h (This file defines the function prototypes for OEM layer for TAPI Call Module.) 322 

OemTapiCommon.h (This file defines the function prototypes for OEM layer for TAPI Common 


and Tunnel Module) ................................... 325 
OemTapiNetText.h (This file defines the function prototypes for OEM layer for TAPI Network 

ТехеМоаше) Нева алы ЫЛЫ ЕО ҰЛЫ Қы ШЕР Ы Қа 321 
OemTapiNetwork.h (This file defines the function prototypes for ОЕМ layer for TAPI Network 

Module у. cores ena аа ыз ҰЛЫ Ша ДУ Ал ы аай Арат» 330 


OemTapiSim.h (This file defines the function prototypes for OEM layer for ТАРІ SIM Module) 333 
OemTapiSS.h (This file defines the function prototypes for OEM layer for TAPI SS Module ) . . 336 
TelCall.h (This file serves as a "C" header file defines structures for Тарі Call Services.) . . . . . 339 
TelNetText.h (This file serves as a "C" header file defines structures for Tapi Network Text Services.)342 
TelNetwork.h (This file serves as a "C" header file defines structures for Tapi Network Services.) 344 
TelSim.h (This file serves as a "C" header file defines structures for Тарі SIM Services.) . . . . . 346 
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Chapter 5 


Module Documentation 


5.1 


Files 


CallServices 


file OemTapiCall.h 


This file defines the function prototypes for OEM layer for TAPI Call Module. 

Note: Call related Supplementary services are dependent on Operator/Market/Vendor.If any of call related 
supplementary service is not supported in underlying telephony provider due to dependencies, then SS APIs 
may return an error TAPI API NOT SUPPORTED from OEM Adaptation layer. 


Modules 


TelOemCallSetupReq 
TelOemCallAnswerReq 
TelOemCallReleaseReq 
TelOemCallSendDtmfReq 
TelOemCallRetrieveReq 
TelOemCallHoldReq 
TelOemCallJoinReq 
TelOemCallSplitReq 
TelOemCallTransferReq 
TelOemCallSendDtmfCnf 
TelOemCallSetupCnf 
TelOemCallReleaseCnf 
TelOemCallAnswerCnf 
TelOemCallHoldCnf 
TelOemCallRetrieveCnf 
TelOemCallJoinCnf 
TelOemCallSplitCnf 
TelOemCallTransferCnf 
TelOemCallIncomingInd 
TelOemCallAlertInd 
TelOemCallConnectedInd 
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TelOemCallConnectingInd 
TelOemCallEndInd 
TelOemCallForwardInd 
TelOemCallRetrieveInd 
TelOemCallHoldInd 
TelOemCallTransferInd 
TelOemCallJoinInd 
TelOemCall WaitingInd 
TelOemCallUserInfoInd 


Functions 


* void tapi_oem_call_set_incoming_line (unsigned char line) 


void tapi oem call set current call number (unsigned char CallId) 


BOOL tapi oem call on hold released ind (int CallId, TelCallCause t Cause) 


BOOL tapi oem call alert remote ect ind (int CallId, TelCallCause t Cause) 
BOOL арі oem call connected remote ect ind (int CallId, TelCallCause t Cause) 
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5.2 TelOemCallSetupReq 


Functions 


• TapiResult t TelOemCallSetupReq (const TelCallSetupParams t *pParams) 


This function requests to originate the MO call. 


5.2.1 Function Documentation 
5.2.1.4 TapiResult t TelOemCallSetupReq (const TelCallSetupParams t x pParams) 
This function requests to originate the MO call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemCallSetupCnf() TelOemCallConnectingInd(), TelOemCallAlertIndQ, TelOemCall- 
WaitingInd(), TelOemCallForwardInd(), TelOemCallConnectedInd() TelOemCallEndInd() APIs 
are used to send the asynchronous responses for this request. Call identifier(callid) is generated 
by OEM and provided to Telephony server using TelOemCallSetupCnf() API. Telephony Server 
makes use Call identifier to manage the call until the call is ended. Telephony server uses the 
call identifier to identify the call handle and request to provide the indication to the Telephony 
clients 


OEM Adaptation layer has to provide call identifier using TelOemCallSetupCnf() API. In case of call setup 
failure, a call end indication with call identifier is provided using TelOemCallEndInd() API 


Warning: 
* None. 


Parameters: 


< pParams ” TelCallSetupParams t contains Information required for establishing a voice call 
and other supplementary information for the call 


Async Response Message: 


* TelOemCallSetupCnf() Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.3 TelOemCallAnswerReq 


Functions 


* TapiResult t TelOemCallAnswerReq (int CallId, TelCallAnswerType t AnsType) 


This function answers the incoming call (either accept or reject the incoming call). 


5.31 Function Documentation 
5.3.1.1 TapiResult t TelOemCallAnswerReq (int Са а, TelCallAnswerType_t AnsType) 
This function answers the incoming call (either accept or reject the incoming call). 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemCallConnectingInd() ог TelOemCallEndInd() APIs are used to indicate whether the call 
18 accepted or rejected. 


Warning: 
* None. 


Parameters: 


< СаШа Call Identifier 


< AnsType TAPI CALL ANSWER ACCEPT - accept the incoming call, TAPI CALL - 
ANSWER REJECT Reject the incoming call. 


Async Response Message: 


* TelOemCallAnswerCnf() Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.4 TelOemCallReleaseReq 


Functions 


* TapiResult t TelOemCallReleaseReq (int CallId) 


This function releases call identified by callid, (active, held, waiting). 


5.41 Function Documentation 
5.4.1.1 TapiResult t TelOemCallReleaseReq (int CallId) 


This function releases call identified by callid, (active, held, waiting). 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemCallEndInd() API will be used to send the asynchronous response indicating the call is 
ended. 


Warning: 
* None. 


Parameters: 


< CallId Call Identifier 


Async Response Message: 


* TelOemCallReleaseCnf() Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.5 TelOemCallSendDtmfReq 


Functions 


• TapiResult t TelOemCallSendDtmfReq (char *pDtmfString) 
This function sends DTMF strings during the call. 


5.5.1 Function Documentation 
5.5.1.1 TapiResult t TelOemCallSendDtmfReq (char х pDtmfString) 
This function sends DTMF strings during the call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pDtmfString А null terminated DTMF String 


Async Response Message: 


* TelOemCallSendDtmfCnf() Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* Active call should be present. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.6 TelOemCallRetrieveReq 


Functions 


* TapiResult t TelOemCallRetrieveReq (int CallId) 
This function retrieves the held call. The call identified by the call handle must be in held state. 


5.6.1 Function Documentation 
5.6.11 TapiResult_t TelOemCallRetrieveReq (int Са а) 


This function retrieves the held call. The call identified by the call handle must be in held state. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 
Warning: 
* None. 
Parameters: 
< CallId Identifier for the call which has to be made active from held state 


Async Response Message: 


* TelOemCallRetrieveCnf will be called by OEM Adaptation layer to propagate the result to the 
Telephony Server. 


Pre Conditions: 


* The call identified by callId must be in held state and no active call should be present.. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.7 TelOemCallHoldReq 


Functions 


* TapiResult t TelOemCallHoldReq (int CallId) 


This function puts the given call on hold. The call identified by call identifier must be in active state. 


5.7.4 Function Documentation 
5.7.11 TapiResult t TelOemCallHoldReq (int CallId) 


This function puts the given call on hold. The call identified by call identifier must be in active state. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< CallId Identifier for the call which has to put on hold 


Async Response Message: 
* TelOemCallHoldCnf will be called by OEM Adaptation layer to propagate the result to the Tele- 
phony Server. 
Pre Conditions: 


* The call identified by callId must be in active state . 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.8 TelOemCallJoinReq 


Functions 


• TapiResult t TelOemCallJoinReq (int ActiveCallId, int HeldCallId) 


This function joins the active call and the held call into a conference mode. Either of the call handle 
(Active/held) will become an MPTY-call-id and the other will join the conference. 


5.8.1 Function Documentation 
5.8.11 TapiResult t TelOemCallJoinReq (int ActiveCallld, int HeldCallld) 


This function joins the active call and the held call into a conference mode. Either of the call handle 
(Active/held) will become an MPTY-call-id and the other will join the conference. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
< АсйуеСаШа Active Call identifier 
— HeldCallld Held call identifier 
Async Response Message: 


* TelOemCallJoinCnf will be called by OEM Adaptation layer to propagate the result to the Tele- 
phony Server. 


Pre Conditions: 


* One call should be in Active state and another in Hold state.. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.9 TelOemCallSplitReq 


Functions 


* TapiResult t TelOemCallSplitReq (int CallId) 


This function splits a private call from multiparty call. 


5.9.1 Function Documentation 
5.9.1.1 TapiResult t TelOemCallSplitReq (int Са а) 
This function splits a private call from multiparty call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— CallId Call identifier which needs to be splitted into a separate active call from conference 


Async Response Message: 
* TelOemCallSplitCnf will be called by OEM Adaptation layer to propagate the result to the Tele- 
phony Server. 
Pre Conditions: 


* Given call identifier should be part of conference call.. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.10 TelOemCallTransferReq 


Functions 


* TapiResult t TelOemCallTransferReq (int CallId) 


This function invokes the explicit call transfer. On successful execution, the active and held call identifiers 
will no longer be valid. 


5.10.1 Function Documentation 
5.10.1.1  TapiResult t TelOemCallTransferReq (int CallId) 


This function invokes the explicit call transfer. On successful execution, the active and held call identifiers 
will no longer be valid. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


• On successful transfer, TelOemCallEndInd() indication must be sent by the OEM for the active 
and held calls. 


Warning: 
* None. 
Parameters: 
< CallId Callid of an active call 
Async Response Message: 


* TelOemCallTransferCnf() will be called by OEM Adaptation layer to propagate the result to the 
Telephony Server. 


Pre Conditions: 


* One Active call and One held call should be present. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.11 TelOemCallSendDtmfCnf 


Functions 


* BOOL TelOemCallSendDtmfCnf (TelCallCause t Cause) 


This function is called to send a response for sending DTMF tones confirmation in a call. 


5.11.1 Function Documentation 
5.11.11 BOOL TelOemCallSendDtmfCnf (TelCallCause t Cause) 
This function is called to send a response for sending DTMF tones confirmation in a call. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


e This API is called in response to TelOemCallSendDtmfReq() to propagate the results 


Warning: 
* None. 


Parameters: 


< Cause Cause value for the request operation - Success or failure. If Faliure, why. 


Async Response Message: 
NA 


Pre Conditions: 


* TelOemCallSendDtmfReq should be called in prior.. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.12 TelOemCallSetupCnf 


Functions 


* BOOL TelOemCallSetupCnf (int CallId, TelCallCause t Cause) 
This function is called to indicate that Call Setup is being requested at the OEM Telephony provider. 


5.12.1 Function Documentation 
5.12.11 BOOL TelOemCallSetupCnf (int CallId, TelCallCause t Cause) 


This function is called to indicate that Call Setup is being requested at the OEM Telephony provider. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallSetupReq() to provide the Call identifier generated 
by the modem to TS for managing the call until the end of the call. 


Warning: 
* None. 


Parameters: 


< CallId Call identifier generated by OEM which is used for entire call session. 


< Cause Cause value for the request operation - Success or failure. If Faliure, why. 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.13 TelOemCallReleaseCnf 


Functions 


• BOOL TelOemCallReleaseCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send an asynchronous response for the call-release request. 


5.13.1 Function Documentation 
5.13.11 BOOL TelOemCallReleaseCnf (int CallId, TelCallCause t Cause) 
This function is invoked to send an asynchronous response for the call-release request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallReleaseReq() to propagate the results. 


Warning: 
* None. 


Parameters: 


— CallId Call identifier for which call-release has been requested 
— Cause Cause value for the request operation - Success or failure. If Faliure, why. 
Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.14 TelOemCallAnswerCnf 


Functions 


* BOOL TelOemCallAnswerCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send an asynchronous response for the call-answer request. 


5.14.1 Function Documentation 
5.14.11 BOOL TelOemCallAnswerCnf (int CallId, TelCallCause t Cause) 
This function is invoked to send an asynchronous response for the call-answer request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallAnswerReq() to propagate the results. 


Warning: 
* None. 
Parameters: 


< CallId Call identifier for which call-answer has been requested 


— Cause Cause value for the request operation - Success or failure. If Faliure, why. 


Async Response Message: 


NA 


Pre Conditions: 


* Answer request for a particular ID should have been requested.. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.15 TelOemCallHoldCnf 


Functions 


* BOOL TelOemCallHoldCnf (int CallId, TelCallCause t Cause) 


This function is called to send an asynchronous response for the hold request. 


5.15.1 Function Documentation 
5.15.11 BOOL TelOemCallHoldCnf (int CallId, TelCallCause t Cause) 
This function is called to send an asynchronous response for the hold request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallHoldReq() to propagate the results. 


Warning: 
* None. 


Parameters: 


— CallId Call identifier for which hold has been requested 
— Cause Cause value for the request operation - Success or failure. If Faliure, why. 


Async Response Message: 


NA 


Pre Conditions: 


* Hold request for a particular ID should have been requested.. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.16  TelOemCallRetrieveCnf 


Functions 


* BOOL TelOemCallRetrieveCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response for the retrieve request. 


5.16.1 Function Documentation 
5.16.11 BOOL TelOemCallRetrieveCnf (int Са а, TelCallCause t Cause) 
This function is invoked to send a response for the retrieve request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallRetrieveReq to propagate the results 


Warning: 


* None. 


Parameters: 


< СаШа Call Identifier 


— Cause Cause value for the request operation - Success or failure. If Faliure, why. 


Async Response Message: 
NA 


Pre Conditions: 


* The call identified by саШа must be in held state .. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.17 TelOemCallJoinCnf 


Functions 


• BOOL TelOemCallJoinCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response from Oem to telephony server regarding the acceptance of the 
call join request. 


5.17.1 Function Documentation 
5.17.11 BOOL TelOemCallJoinCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response from Oem to telephony server regarding the acceptance of the 
call join request. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* This API is called in response to TelOemCallJoinReq to propagate the results. 
Warning: 
* None. 
Parameters: 
< CallId MPTY Call identifier 
* 
Parameters: 
— Cause Cause value for the request operation - Success or failure. If Faliure, why. 
Async Response Message: 
NA 
Pre Conditions: 
* The Multiparty request must have been sent to the network.. 
Post Conditions: 
* None. 
Returns: 
BOOL 
* Specifies whether the API response is success or failure 
Prospective Clients: 


OEM Adaptation Layer. 
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5.18 TelOemCallSplitCnf 


Functions 


e BOOL TelOemCallSplitCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response for split call request from conference. 


5.18.1 Function Documentation 
5.18.11 BOOL TelOemCallSplitCnf (int Са а, TelCallCause t Cause) 
This function is invoked to send a response for split call request from conference. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallSplitReq to propagate the results 
Warning: 
* None. 


Parameters: 


< CallId Call identifier for the split call from the Mpty call (conference call) 


* 
Parameters: 

< Cause Cause value for the request operation - Success or failure. If Faliure, why. 
Async Response Message: 

NA 


Pre Conditions: 


* Split Multiparty request should be already placed.. 
Post Conditions: 
* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.19 TelOemCallTransferCnf 


Functions 


e BOOL TelOemCallTransferCnf (int CallId, TelCallCause t Cause) 


TThis function is called to send a response for the explicit transfer request. 


5.19.1 Function Documentation 
5.19.11 BOOL TelOemCallTransferCnf (int CallId, TelCallCause t Cause) 
TThis function is called to send a response for the explicit transfer request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* This API is called in response to TelOemCallTransferReq to propagate the results 
Warning: 
* None. 


Parameters: 


< CallId Call identifier of an active call sent in the request 


* 
Parameters: 

< Cause Cause value for the request operation - Success or failure. If Faliure, why. 
Async Response Message: 

NA 


Pre Conditions: 


* Explicit call transfer request should be already triggered. 
Post Conditions: 
* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.20 TelOemCallIncomingInd 


Functions 


• BOOL TelOemCallIncomingInd (int CallId, const TelCallIncomingCallInfo t «pIncomCallInfo) 


This function is called to send the incoming call indication to an Application. 


5.20.1 Function Documentation 


5.20.1.1 BOOL TelOemCallIncomingInd (int CallId, const TelCallIncomingCallInfo t x 
plncomCallInfo) 


This function is called to send the incoming call indication to an Application. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* TelOemCallAnswerReq is used to answer the call 


Warning: 


* None. 


Parameters: 


< CallId Call Identifier 


< pIncomCallInfo Incoming Call Information 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.21 TelOemCallAlertInd 


Functions 


• BOOL TelOemCallAlertInd (int CallId) 


This function is invoked to send alert indication from the lower layers. 


521.1 Function Documentation 
5.21.11 BOOL TelOemcCallAlertInd (int Са а) 
This function is invoked to send alert indication from the lower layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* [f UUSI is received in the Alert Message from Network, then TelOemCallUserInfoInd API will 
be called prior to this API. 
Warning: 


* None. 


Parameters: 


< CallId Call Identifier 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.22 TelOemCallConnectedInd 


Functions 


* BOOL TelOemCallConnectedInd (int CallId) 


This function is invoked to send a connected indication from the lower layers. 


522.1 Function Documentation 
5.22.11 BOOL TelOemCallConnectedInd (int CallId) 
This function is invoked to send a connected indication from the lower layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
e If UUSI is received in the Connect Message from Network, then TelOemCallUserInfoInd API 
will be called prior to this API. 
Warning: 


* None. 


Parameters: 


< CallId Call Identifier 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.23 TelOemCallConnectingInd 


Functions 


* BOOL TelOemCallConnectingInd (int CallId) 


This function is invoked to send a connecting indication from the lower layers. 


523.1 Function Documentation 
5.23.11 BOOL TelOemCallConnectingInd (int CallId) 
This function is invoked to send a connecting indication from the lower layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
e If UUSI is received in the Progress Message from Network, then TelOemCallUserInfoInd API 
will be called prior to this API. 
Warning: 


* None. 


Parameters: 


< CallId Call Identifier 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.24 TelOemCallEndInd 


Functions 


* BOOL TelOemCallEndInd (int CallId, TelCallCause t Cause) 


This function is invoked to send the call end indication triggered by the user or from the network or by the 
modem due to low coverage or some other reasons. 


5.24.1 Function Documentation 
5.24.11 BOOL TelOemCallEndInd (int CallId, TelCallCause t Cause) 


This function is invoked to send the call end indication triggered by the user or from the network or by the 
modem due to low coverage or some other reasons. 


Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


* Call id will be cleared in TS after informing the call end indication to application. Any further 
request for the same call id will be rejected at TS. 


If UUSI is received in the Release Message from Network, then TelOemCallUserInfoInd API will be called 
prior to this API. 


Warning: 
* None. 
Parameters: 
< Callld Call Identifier 
— Cause Cause value specifies the nature of Call end i.e user triggered or due to some network failure. 
Async Response Message: 
NA 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.25 TelOemCallForwardInd 


Functions 


* BOOL TelOemCallForwardInd (int CallId) 


This function is called to provide the remote call forwarding indication received at OEM. 


525.1 Function Documentation 
5.25.11 BOOL TelOemCallForwardInd (int CallId) 
This function is called to provide the remote call forwarding indication received at OEM. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 
Parameters: 
< CallId Call Identifier 
Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.26 TelOemCallRetrievelInd 


Functions 


* BOOL TelOemCallRetrieveInd (int CallId) 


This function sends an indication that the remote party has been retrieved its held call. 


5.26.1 Function Documentation 


5.26.1.11 BOOL TelOemcCallRetrieveInd (int CallId) 


This function sends an indication that the remote party has been retrieved its held call. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None 
Warning: 
* None. 
Parameters: 
< CallId Call Identifier 
Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.27 TelOemCallHoldInd 


Functions 


e BOOL TelOemCallHoldInd (int CallId) 


ThThis function is invoked to send remote side call hold indication. 


5.27.1 Function Documentation 
5.27.11 BOOL TelOemCallHoldInd (int CallId) 
ThThis function is invoked to send remote side call hold indication. 
Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 
Parameters: 
— CallId Call Identifier 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.28  TelOemCallTransferInd 


Functions 


* BOOL TelOemCallTransferInd (int CallId) 


This function is invoked to send an indication related with the remote party explicit call transfer. 


5.28.1 Function Documentation 


5.28.1.1 BOOL TelOemCallTransferInd (int CallId) 


This function is invoked to send an indication related with the remote party explicit call transfer. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 
Parameters: 
< CallId Call Identifier 
Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.29 TelOemCallJoinInd 


Functions 


* BOOL TelOemCallJoinInd (int CallId) 


This function is invoked to send an indication when a call is joined in the conference call.(multiparty call). 


5.291 Function Documentation 
5.29.1.1 BOOL TelOemCallJoinInd (int CallId) 
This function is invoked to send an indication when a call is joined in the conference call.(multiparty call). 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 
Parameters: 
< CallId Call Identifier 
Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.30 TelOemCallWaitingInd 


Functions 


* BOOL TelOemCallWaitingInd (int CallId) 


This function is called to provide the remote call forwarding indication received at OEM. 


5.30.1 Function Documentation 


5.30.1.1 BOOL TelOemCallWaitingInd (int CallId) 


This function is called to provide the remote call forwarding indication received at OEM. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< CallId Call Identifier 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.31 TelOemCallUserInfoInd 


Functions 


e BOOL TelOemCallUserInfoInd (int CallId, const TelCallUusInfo t *ptr uus, info) 


This function is invoked to send an indication related with the user-to-user(UUSI) information received 
from network during call establishment procedures and call end based on 3GPP 24.008 TS. 


5.31.4 Function Documentation 
5.31.1.1 BOOL TelOemCallUserInfoInd (int CallId, const TelCallUusInfo t « ptr uus info) 


This function is invoked to send an indication related with the user-to-user(UUS1) information received 
from network during call establishment procedures and call end based on 3GPP 24.008 TS. 


Only UUSI is supported in R1. 
Sync (or) Async: 

This is a Synchronous API. 
Important Notes: 


e If OEM Telephony Provider receives User-to-user information(UUS1) in Alert(ALERT_- 
IND), Progress(CONNECTING IND), Connect(CONNECT IND), Disconnect/Release proce- 
dure (END IND) from Network, then this indication API shall be called prior calling the corre- 
sponding Alert, Connecting, Connected or End indication APIs. 


Warning: 
* None. 
Parameters: 
< СаШа Call Identifier 
< ptr uus info User-User information (UUS1) 
Async Response Message: 
NA 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.32 UtilityServices 


Files 


* file OemTapiCommon.h 
This file defines the function prototypes for OEM layer for TAPI Common and Tunnel Module. 


Modules 


* TelOemInitReq 

• TelOemDelInitReq 

* TelOemInitCnf 

* TelOemDelInitCnf 

* TelOemPhoneStatusInd 
* TelOemTunnelReq 

* TelOemTunnelCnf 

е TelOemTunnelInd 


Enumerations 


* enum TelOemPhoneStatus t ( 


OEM INIT COMPLETED, ОЕМ INIT FAILED, ОЕМ DEINIT COMPLETED, ОЕМ - 
DEINIT FAILED, 


OEM PHONE RESET IND ] 


5.32.1 Enumeration Type Documentation 
5.32.1.1 enum TelOemPhoneStatus_t 
This enum defines the phone status information 


Enumerator: 


OEM_INIT_COMPLETED Оет initialization completed 
OEM_INIT_FAILED Oem initialization failed 

OEM DEINIT COMPLETED Oem de-initialization completed 
OEM DEINIT FAILED Oem De-initialization failed 


OEM PHONE RESET IND Phone reset indication (Underlying OEM Telephony provider under- 
gone a reset) 
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5.33 TelOemlInitReq 


Functions 


• TapiResult t TelOemInitReq (void) 


This function shall be called during Telephony Server initialization when started. As OEM Adaptation layer 
is a plug-in, Initialization of OEM Adaptation layer plug-in should be handled in this API functionality. 
This initialization function is vendor specific implementation. 


5.33.1 Function Documentation 
5.33.1.1 TapiResult t TelOemInitReq (void) 


This function shall be called during Telephony Server initialization when started. As OEM Adaptation layer 
is a plug-in, Initialization of OEM Adaptation layer plug-in should be handled in this API functionality. 
This initialization function is vendor specific implementation. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemInitCnf() Api will be used to send the confirmation with a status of Success or failure 
(OEM INIT COMPLETED/ ОЕМ INIT FAILED). In case of failure, no further TAPI requests 
will be processed and an error will be returned. 


Warning: 


* None. 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 


* [n case of success, О will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.34 TelOemDelnitReq 


Functions 


* TapiResult t TelOemDelnitReq (void) 


This function shall be called during Telephony Server de-initialization procedure. As OEM Adaptation layer 
is a plug-in, De-Initialization of OEM Adaptation layer plug-in should be handled in this API functionality. 
This De-initialization function is vendor specific implementation. 


5.34.1 Function Documentation 
5.34.1.1 TapiResult t TelOemDelnitReq (void) 


This function shall be called during Telephony Server de-initialization procedure. As OEM Adaptation 
layer is a plug-in, De-Initialization of OEM Adaptation layer plug-in should be handled in this API func- 
tionality. This De-initialization function is vendor specific implementation. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


e TelOemDelnitCnf() Api will be used to send the confirmation for this request with a staus of 
Success or failure (OEM. DEINIT COMPLETED/ ОЕМ DEINIT FAILED). 


Warning: 


* None. 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 


* [n case of success, О will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.35 TelOemInitCnf 


Functions 


* BOOL TelOemlnitCnf (TelOemPhoneStatus t PhoneStatus) 


This function is used to send the confirmation of the Oem Init request to the upper layers. 


5.35.1 Function Documentation 
5.35.1.4 BOOL TelOemInitCnf (TelOemPhoneStatus t PhoneStatus) 
This function is used to send the confirmation of the Oem Init request to the upper layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< PhoneStatus ° Specifies whether the initialization request is success or failure ie. (ОЕМ - 
INIT COMPLETED/ OEM INIT FAILED). 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.36 TelOemDelnitCnf 


Functions 


* BOOL TelOemDelnitCnf (TelOemPhoneStatus t PhoneStatus) 


This function is used to send the confirmation of the Oem De-Init request to the upper layers. 


5.36.1 Function Documentation 
5.36.1.11 BOOL TelOemDelnitCnf (TelOemPhoneStatus t PhoneStatus) 
This function is used to send the confirmation of the Oem De-Init request to the upper layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< PhoneStatus ° Specifies whether the initialization request is success or failure іе. (ОЕМ - 
INIT COMPLETED/ OEM INIT FAILED). 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.37 TelOemPhoneStatusInd 


Functions 


* BOOL TelOemPhoneStatusInd (TelOemPhoneStatus_t PhoneStatus) 


This function is used to indicate the OEM phone reset indication to the Telphony Server. This indication 
should be sent by OEM Adaptation layer after reset has completed and OEM Telephony Provider is ready 
to receive further requests. 


5.37.1 Function Documentation 
5.37.11 BOOL TelOemPhoneStatusInd (TelOemPhoneStatus t PhoneStatus) 
This function is used to indicate the OEM phone reset indication to the Telphony Server. This indication 


should be sent by OEM Adaptation layer after reset has completed and OEM Telephony Provider is ready 
to receive further requests. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 


* None. 


Parameters: 


— PhoneStatus • Phone status information іе (OEM, PHONE RESET IND) 


Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.38 TelOemTunnelReq 


Functions 


• TapiResult t TelOemTunnelReq (const TelTapiTunnelInfo t *pTunnelInfo, int RequestId) 


This function is used to transfer vendor specific data transparently to the OEM. This API can be used for 
vendor specific procedures. 


5.38.1 Function Documentation 
5.38.1.1  TapiResult t TelOemTunnelReq (const TelTapiTunnelInfo t * pTunnelInfo, int RequestId) 


This function is used to transfer vendor specific data transparently to the OEM. This API can be used for 
vendor specific procedures. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Parameters: 
< pTunnellnfo • Tunnel information containting tunnel data length and tunnel data 
< Requestld ” Request identifier for the tunnel request. 
Warning: 
* None. 
Async Response Message: 
NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 


* [n case of success, О will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.39 TelOemTunnelCnf 


Functions 


e BOOL TelOemTunnelCnf (const TelTapiTunnelInfo t *pTunnelInfo, int RequestId) 


This function is used to provide confirmation for Tunnel request API. This API is used to transfer vendor 
specific data transparently. 


5.39.1 Function Documentation 
5.39.11 BOOL TelOemTunnelCnf (const TelTapiTunnelInfo t x pTunnelInfo, int RequestId) 


This function is used to provide confirmation for Tunnel request API. This API is used to transfer vendor 
specific data transparently. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Parameters: 


< pTunnellnfo • Tunnel information containting tunnel data length and tunnel data 


< Requestld ” Same request identifier sent in tunnel request API. 


Warning: 
* None. 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.40 TelOemTunnelInd 


Functions 


* BOOL TelOemTunnelInd (const TelTapiTunnelInfo_t TunnelInfo) 


This function is used to indicate the unsolicited Tunnelling information transparently. 


5.40.1 Function Documentation 
5.40.11 BOOL TelOemTunnellInd (const TelTapiTunnelInfo t TunnelInfo) 
This function is used to indicate the unsolicited Tunnelling information transparently. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 


Parameters: 


< TunnelInfo | * Tunnel information containting tunnel data length and tunnel data 
Warning: 
* None. 


Async Response Message: 


NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.41  NetTextServices 


Files 


file OemTapiNetText.h 


This file defines the function prototypes for OEM layer for TAPI Network Text Module. 


Modules 


TelOemSmsSendReq 
TelOemSmsReadReq 
TelOemSmsWriteReq 
TelOemSmsDeleteReq 
TelOemSmsSetSCAReq 
TelOemSmsGetCountReq 
TelOemSmsCBGetConfigReq 
TelOemSmsCBSetConfigReq 
TelOemSmsGetPreferredBearerReq 
TelOemSmsSetPreferredBearerReq 
TelOemSmsSendDeliveryReportReq 
TelOemSmsSetParametersReq 
TelOemSmsGetParametersReq 
TelOemSmsSendCnf 
TelOemSmsReadCnf 
TelOemSmsCBGetConfigCnf 
TelOemSmsGetParametersCnf 
TelOemSmsDeleteCnf 
TelOemSmsWriteCnf 
TelOemSmsSendDeliveryReportCnf 
TelOemSmsSetPreferredBearerCnf 
TelOemSmsSetSCACnf 
TelOemSmsCBSetConfigCnf 
TelOemSmsSetParametersCnf 
TelOemSmsGetPreferredBearerCnf 
TelOemSmsGetCountCnf 
TelOemSmsCBIncomingInd 
TelOemSmsIncomingInd 
TelOemSmsMemoryStatusInd 
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5.42 TelOemSmsSendReq 


Functions 


е TapiResult t TelOemSmsSendReq (const TelSmsDatapackageInfo t *pDataPackage, BOOL b- 
MoreMsgToSend, int RequestId) 


This function sends an SMS message to OEM provider in order to transmit to Network. 


5.421 Function Documentation 


5.42.1.1 TapiResult t TelOemSmsSendReq (const TelSmsDatapackageInfo_t x pDataPackage, 
BOOL bMoreMsgToSend, int RequestId) 


This function sends an SMS message to OEM provider in order to transmit to Network. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* TelOemSmsSendCnf()is the confirmation API for this request. 


Warning: 


* None. 


Parameters: 


< pDataPackage ” SMS-SUBMIT message structure. it contains string pointer field and length 
field of the message. Message byte stream should be coded as per 3GPP TS 23.040 SMS 
TPDU 


< bMoreMsgToSend  * This parameter hints the OEM that there can be further messages and it 
can choose to keep the channel open. 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 
• Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server 
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5.43 TelOemSmsReadReq 


Functions 


* TapiResult t TelOemSmsReadReq (int Index, int RequestId) 


This function reads a message from SIM card for provided index.It uses index number to identify the message. 


5.43.1 Function Documentation 
5.43.1.1 TapiResult t TelOemSmsReadReq (int Index, int RequestId) 


This function reads a message from SIM card for provided index.It uses index number to identify the 
message. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* TelOemSmsReadCnf is the corresponding confirmation API. 


* Total number of messages can be retrieved by TelOemSmsGetCountReq function. 
Warning: 
* None. 


Parameters: 


< Index | * Sim Index of the message to be read 
< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


* Invalid RequestId has value -1). 
Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
-In case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.44 TelOemSmsWriteReq 


Functions 


e TapiResult_t TelOemSmsWriteReq (TelSmsMessageStatus_t MsgStatus, const TelSms- 
DatapackageInfo_t *pDataPackage, int RequestId) 


This function writes/saves a message to SIM storage area. 


5.441 Function Documentation 


5.44.1.1 TapiResult t TelOemSmsWriteReq (Tel8msMessageStatus t MsgStatus, const 
TelSmsDatapackageInfo t x pDataPackage, int RequestId) 


This function writes/saves a message to SIM storage area. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemSmsWiriteCnf is the corresponding confirmation API. 


Warning: 


* None. 


Parameters: 


< MsgStatus • Message status information 


< pDataPackage • Message content to write/save.It shall be either SMS-SUBMIT or SMS- 
DELIVER or SMS-STATUS-REPORT type Message. 


* coded according to 3GPP TS 23.040 9.2.2.1 specification 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 
Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server 
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5.45 TelOemSmsDeleteReq 


Functions 


e TapiResult t TelOemSmsDeleteReq (int Index, int RequestId) 


This function is used to delete the SMS for the provided index(sim index where the SMS record is stored). 


5.45.1 Function Documentation 
5.45.1.1 TapiResult t TelOemSmsDeleteReq (int Index, int RequestId) 
This function is used to delete the SMS for the provided index(sim index where the SMS record is stored). 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 

e TelOemSmsDeleteCnf is the corresponding confirmation API. 
Warning: 

* None. 


Parameters: 


< Index | * Sim index of the SMS Message to be deleted. 


< Requestld • Unique identifier for a particular request. 
e (RequestlId value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 


Async Response Message: 
* МА 
Pre Conditions: 


* None. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server 
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5.46 TelOemSmsSetSCAReq 


Functions 


* TapiResult t TelOemSmsSetSCAReq (const TelSmsAddressInfo_t *pSCAddr) 


This function is used to set SMS Service Centre Address information. 


5.46.1 Function Documentation 
5.46.1.1  TapiResult t TelOemSmsSetSCAReq (const Tel8msAddressInfo t x pSCAddr) 
This function is used to set SMS Service Centre Address information. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemSmsSetSCACnf is the corresponding response for this request. 


Warning: 
* None. 


Parameters: 


< pSCAddr ” SmsAddressInfo consists of Type of Number, Numbering plan, Service Center Ad- 
dress. 


Async Response Message: 
-NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.47 TelOemSmsGetCountReq 


Functions 


* TapiResult t TelOemSmsGetCountReq (int RequestId) 


This function is used to retrieve message count and the list from Sim storage. 


5.47.1 Function Documentation 
5.47.1.1 TapiResult t TelOemSmsGetCountReq (int Requestld) 
This function is used to retrieve message count and the list from Sim storage. 
Sync (or) Async: 
This is an Asynchronous API. 

Important Notes: 

* TelOemSmsGetCountCnf is the corresponding response. 
Warning: 

* None. 


Parameters: 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.48 TelOemSmsCBGetConfigReq 


Functions 


* TapiResult t TelOemSmsCBGetConfigReq (int RequestId) 


This function is used to retrieve SMS CB configuration options. 


5.48.1 Function Documentation 
5.48.1.1 TapiResult t TelOemSmsCBGetConfigReq (int RequestId) 
This function is used to retrieve SMS CB configuration options. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


-Refer 3GPP TS 23.041 specification. TelOemSmsCBGetConfigCnf is the response for this request. 


Warning: 
* None. 


Parameters: 


< Requestld • Unique identifier for a particular request. 
e RequestlId value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.49 TelOemSmsCBSetConfigReq 


Functions 


e TapiResult t TelOemSmsCBSetConfigReq (const TelSmsCbConfig_t *pCBConfig, int RequestId) 
This function is used to set SMS CB configuration. 


5.49.1 Function Documentation 


5.49.1.1 TapiResult t TelOemSmsCBSetConfigReq (const TelSmsCbConfig_t x pCBConfig, int 
RequestId) 


This function is used to set SMS CB configuration. 
Sync (or) Async: 

This is an Asynchronous API. 
Important Notes: 


* Refer 3GPP TS 23.041 9.4.1 
* TelOemSmsCBSetConfigCnf is the corresponding response for this request. 


Warning: 
* None. 


Parameters: 


< pCBConfig • Parameters to set SMS CB configuration 
< Requestld • Unique identifier for a particular request. 
e (RequestlId value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 


Async Response Message: 
-NA 
Pre Conditions: 
* None. 
Post Conditions: 
* None 
Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.50 TelOemSmsGetPreferredBearerReq 


Functions 


e TapiResult t TelOemSmsGetPreferredBearerReq (int RequestId) 


This function requests the preferred bearer from TS. 


5.50.1 Function Documentation 
5.50.1.1  TapiResult t TelOemSmsGetPreferredBearerReq (int RequestId) 
This function requests the preferred bearer from TS. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* TelOemSmsGetPreferredBearerCnf is the corresponding confirmation API for this request. 


Warning: 
* None. 


Parameters: 


< Requestld • Unique identifier for a particular request. 
e RequestlId value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.51 TelOemSmsSetPreferredBearerReq 


Functions 


е TapiResult t TelOemSmsSetPreferredBearerReq (TelSmsBearerType t SmsBearer, int RequestId) 
This function sets the preferred bearer on which SMS has to be transmitted. 


5.511 Function Documentation 


5.51.1111 TapiResult t TelOemSmsSetPreferredBearerReq (Tel8msBearerType t SmsBearer, int 
RequestId) 


This function sets the preferred bearer on which SMS has to be transmitted. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
-TelOemSmsSetPreferredBearerCnf is the corresponding response for this request. 
Warning: 
* None. 


Parameters: 


< SmsBearer % Preferred service either Circuit switched (CS) or Packet switched (PS) over which 
SMS can be transmitted 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 
Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.52 TelOemSmsSendDeliveryReportReq 


Functions 


е TapiResult г TelOemSmsSendDeliveryReportReq (const TelS$msDatapackageInfo t — «pData- 
Package, int RequestId) 


This function sets the delivery report for received incoming SMS to the network. 


5.52.4 Function Documentation 


5.52.1111 TapiResult t TelOemSmsSendDeliveryReportReq (const Tel8msDatapackagelInfo (ж 
pDataPackage, int RequestId) 


This function sets the delivery report for received incoming SMS to the network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* TelOemSmsSendDeliveryReportCnf is the corresponding response for this request. 


Warning: 


* None. 


Parameters: 


< pDataPackage ” SMS-DELIVER REPORT message structure. it contains string pointer field 
and length field of the message Message byte stream should be coded as per 3GPP TS 23.040 
SMS TPDU 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 


-NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 
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* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.53 TelOemSmsSetParametersReq 


Functions 


е TapiResult t TelOemSmsSetParametersReq (const TelSmsParams t *pSmsParam, int RequestId) 


This function is used to set the parameters for the SMS. 


5.53.4 Function Documentation 


5.53.1.1  TapiResult t TelOemSmsSetParametersReq (const Tel8msParams (ж pSmsParam, int 
RequestId) 


This function is used to set the parameters for the SMS. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* TelOemSmsSetParametersCnf is the corresponding response for this request. 
Warning: 
* None. 


Parameters: 


< pSmsParam • SMS parameters structure 

* Set PARAM structure should be filled as per 3GPP TS 31.102, EF SMSP structure 
< Requestld • Unique identifier for a particular request. 

e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 
Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.54 TelOemSmsGetParametersReq 


Functions 


* TapiResult t TelOemSmsGetParametersReq (int Index, int RequestId) 


This function is used to get the required parameters for SMS by passing the index. 


5.54.1 Function Documentation 
5.54.1.1 TapiResult t TelOemSmsGetParametersReq (int Index, int RequestId) 
This function is used to get the required parameters for SMS by passing the index. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 

* TelOemSmsGetParametersCnf is the corresponding response for this request. 
Warning: 

* None. 


Parameters: 


< Index • Index of the parameter to get. 


< Requestld — * Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 


Async Response Message: 
-NA 
Pre Conditions: 


* None. 


Post Conditions: 
* None 
Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.55 TelOemSmsSendCnf 


Functions 


e BOOL TelOemSmsSendCnf (const Tel$msDatapackagelInfo t *pDataPackage, TelSmsResponse_t 
SmsResponse, int RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


5.55.1 Function Documentation 


5.55.1.11 BOOL TelOemSmsSendCnf (const Tel8msDatapackageInfo t ж pDataPackage, 
TelSmsResponse t SmsResponse, int RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* None. 


Warning: 
* None. 


Parameters: 


< pDataPackage • SMS-SUBMIT-REPORT message structure.Message byte stream shall be in- 
terpreted as per 3GPP TS 23.040 SMS TPDU 


* This structure will be Null in case of error. 
< SmsResponse “% SMS sent response 


< Requestld • Unique identifier for a particular request. 
e (RequestlId value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 


-NA 


Pre Conditions: 


-TelOemSmsSendReq should be called in prior. 


Post Conditions: 


* None 


Returns: 


Return Type (BOOL) 
-Specifies whether the API response is success or failure. 
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Prospective Clients: 


OEM Adaptation Layer. 
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5.56 TelOemSmsReadCnf 


Functions 


* BOOL TelOemSmsReadCnf (const TelSmsData_t *pReadData, TelSmsCause_t SmsCause, int 
RequestId) 


This function used to send the SMS message which is stored in the SIM to the application. 


5.56.1 Function Documentation 


5.56.11 BOOL TelOemSmsReadCnf (const Tel8msData t x pReadData, TelSmsCause_t 
SmsCause, int RequestId) 


This function used to send the SMS message which is stored in the SIM to the application. 
Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< pReadData ” Contains the SMS data package.If smsCause is other than SUCCESS, then pRead- 
Data shall be NULL. 


< SmsCause — * Sms cause value 
< Requestld “ Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 
Async Response Message: 
-NA 
Pre Conditions: 
* TelOemSmsReadReq should be called in prior. 
Post Conditions: 
* None 


Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure . 
Prospective Clients: 


OEM Adaptation Layer. 
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5.57 TelOemSmsCBGetConfigCnf 


Functions 


• BOOL TelOemSmsCBGetConfigCnf (const Tel8msCbConfig t »pCBConfigData, TelSmsCause_t 
SmsCause, int RequestId) 


This function is used to send a response for SMS CB configuration request. 


5.57.1 Function Documentation 


5.57.11 BOOL TelOemSmsCBGetConfigCnf (const TelSmsCbConfig_t х pCBConfigData, 
TelSmsCause t SmsCause, int RequestlId) 


This function is used to send a response for SMS CB configuration request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* Refer 3GPP TS 23.041 specification. 


Warning: 


* None. 


Parameters: 


< pCBConfigData • CB Information.If smsCause is other than SUCCESS, then pCBConfigData 
shall be NULL. 


— SmsCause * Sms cause value 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 


Async Response Message: 


* NA 


Pre Conditions: 


-TelOemSmsCBGetConfigReq should be called in prior. 


Post Conditions: 


* None 


Returns: 


Return Type (BOOL) 
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* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.58 TelOemSmsGetParametersCnf 


Functions 


e BOOL TelOemSmsGetParametersCnf (const TelSmsParams_t *pSmsParams, TelSmsCause_t Sms- 
Cause, int RequestId) 


This function is used to send the response for the TelOemSmsGetParametersReq. 


5.58.4 Function Documentation 


5.58.11 BOOL TelOemSmsGetParametersCnf (const TelSmsParams_t х pSmsParams, 
TelSmsCause t SmsCause, int RequestlId) 


This function is used to send the response for the TelOemSmsGetParametersReq. 
Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< pSmsParams • Contains SMS parameters.If smsCause is other than SUCCESS, then pSms- 
Params shall be NULL. 
< SmsCause — * Sms cause value 
< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 
Async Response Message: 
* МА 
Pre Conditions: 
-TelOemSmsGetParametersReq should be called in prior. 
Post Conditions: 
* None 


Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure . 
Prospective Clients: 


OEM Adaptation Layer. 
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5.59 TelOemSmsDeleteCnf 


Functions 


* BOOL TelOemSmsDeleteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 


This function sends a confirmation to a delete request. 


5.59.1 Function Documentation 
5.59.1.1 BOOL TelOemSmsDeleteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 
This function sends a confirmation to a delete request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< SimIndex | * Sim index from which the message has been deleted. 
< SmsCause — * Sms cause value 
< Requestld • Unique identifier for a particular request. 

e (Requestld value can be any value from 0 to 255. 


* Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* TelOemSmsDeleteReq should be called in prior. 
Post Conditions: 
* None 


Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.60 TelOemSmsWriteCnf 


Functions 


* BOOL TelOemSmsWriteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 


This function sends a confirmation to a write request. 


5.60.1 Function Documentation 
5.60.1.1 BOOL TelOemSmsWriteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 
This function sends a confirmation to a write request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< SimIndex | * Sim Index in which the message stored. 
< SmsCause — * Sms cause value 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* TelOemSmsWriteReq should be called in prior. 
Post Conditions: 
* None 


Returns: 


Return Type (BOOL) 
-Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.61  TelOemSmsSendDeliveryReportCnf 


Functions 


• BOOL TelOemSmsSendDeliveryReportCnf (Tel8msResponse t SmsResponse, int RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


5.611 Function Documentation 


5.61.11 BOOL TelOemSmsSendDeliveryReportCnf (Tel8msResponse t SmsResponse, int 
RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< SmsResponse • SMS sent response 
< Requestld — * Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


e Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* TelOemSmsSendDeliveryReportReq should be called in prior. 


Post Conditions: 


* None 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.62 TelOemSmsSetPreferredBearerCnf 


Functions 


* BOOL TelOemSmsSetPreferredBearerCnf (TelSmsResponse_t Status, int RequestId) 


This function is used to send a confirmation for the TelOemSmsSetPreferredBearerReq. 


5.62.1 Function Documentation 
5.62.1.11 BOOL TelOemSmsSetPreferredBearerCnf (TelSmsResponse_t Status, int Кедиез 4) 


This function is used to send a confirmation for the TelOemSmssSetPreferredBearerReq. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* None 


Warning: 


* None. 


Parameters: 


< Status • SMS Response value 
— RequestId • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 
Async Response Message: 
-NA 
Pre Conditions: 


-TelOemSmsSetPreferredBearerReq should be called in prior. 


Post Conditions: 


* None 


Returns: 

Return Type (BOOL) 

-Specifies whether the API response is success or failure . 
Prospective Clients: 


OEM Adaptation Layer. 
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5.63 TelOemSmsSetSCACnf 


Functions 


* BOOL TelOemSmsSetSCACnf (TelSmsResponse_t Status) 


This function is used to send a confirmation for the set SCA request. 


5.63.1 Function Documentation 
5.63.1.1 BOOL TelOemSmsSetSCACnf (TelSmsResponse_t Status) 
This function is used to send a confirmation for the set SCA request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
-None 
Warning: 
* None. 


Parameters: 


< Status • SMS Response value 


Async Response Message: 
-NA 


Pre Conditions: 


• TelOemSmsSetSCAReq should be called in prior. 


Post Conditions: 


* None 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.64 TelOemSmsCBSetConfigCnf 


Functions 


* BOOL TelOemSmsCBSetConfigCnf (TelSmsResponse_t Status, int RequestId) 


This function is used to send a confirmation for the set CB configuration request. 


5.64.1 Function Documentation 
5.64.1.1 BOOL TelOemSmsCBSetConfigCnf (TelSmsResponse t Status, int RequestId) 
This function is used to send a confirmation for the set CB configuration request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
-None 
Warning: 
* None. 


Parameters: 


< Status • SMS Response value 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 
Async Response Message: 
-NA 


Pre Conditions: 


• TelOemSmsCBSetConfigReq should be called in prior. 


Post Conditions: 


* None 


Returns: 


Return Type (BOOL) 
-Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.65 TelOemSmsSetParametersCnf 


Functions 


* BOOL TelOemSmsSetParametersCnf (TelSmsResponse_t Status, int RequestId) 


This function is used to send a confirmation for the set Parameters request. 


5.65.1 Function Documentation 
5.65.1.1 BOOL TelOemSmsSetParametersCnf (TelSmsResponse t Status, int RequestId) 
This function is used to send a confirmation for the set Parameters request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< Status * SMS Response value 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


• Invalid RequestId has value -1). 


Async Response Message: 
-NA 


Pre Conditions: 


* TelOemSmsSetParametersReq should be called in prior 


Post Conditions: 


* None 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.66 TelOemSmsGetPreferredBearerCnf 


Functions 


* BOOL TelOemSmsGetPreferredBearerCnf (const TelSmsBearerType_t SmsBearer, TelSmsCause_t 
SmsCause, int RequestId) 


This function used to send the response to a TelOemSmsGetPreferredBearerReq. 


5.66.1 Function Documentation 


5.66.1.1 BOOL TelOemSmsGetPreferredBearerCnf (const TelSmsBearerType_t SmsBearer, 
TelSmsCause t SmsCause, int RequestlId) 


This function used to send the response to a TelOemSmsGetPreferredBearerReq. 
Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< SmsBearer % Preferred service either Circuit switched (CS) or Packet switched (PS) over which 
SMS can be transmitted 


< SmsCause % SMS cause value 

< Requestld — * Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 
e Invalid RequestId has value -1). 


Async Response Message: 
-NA 
Pre Conditions: 
* TelOemSmsGetPreferredBearerReq should be called in prior. 
Post Conditions: 
* None 


Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.67 TelOemSmsGetCountCnf 


Functions 


• BOOL TelOemSmsGetCountCnf (const Tel8msStoredMsgCountInfo t »pMsgCountInfo, TelSms- 
Cause t SmsCause, int RequestId) 


This function is used to retrieve message count and the list from sim storage. 


5.67.4 Function Documentation 


5.67.11 BOOL TelOemSmsGetCountCnf (const TelSmsStoredMsgCountInfo_t x pMsgCountInfo, 
TelSmsCause_t SmsCause, int RequestlId) 


This function is used to retrieve message count and the list from sim storage. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


-None 


Warning: 


* None. 


Parameters: 


< pMsgCountInfo • Contains total number of messages present and message index details.If sms- 
Cause is other than SUCCESS, then pMsgCountInfo shall be NULL. 


— SmsCause * SMS cause value 


< Requestld • Unique identifier for a particular request. 
e (Requestld value can be any value from 0 to 255. 


* Invalid RequestId has value -1). 


Async Response Message: 


* МА 


Pre Conditions: 


* TelOemSmsGetCountReq should be called in prior. 


Post Conditions: 


* None 


Returns: 


Return Type (BOOL) 
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* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.68 TelOemSmsCBlIncomingInd 


Functions 


• BOOL TelOemSmsCBIncomingInd (const TelSmsCbMsg_t *pCBMsgInfo) 


This function is used to inform about an incoming cell broadcast service for GSM and UMTS. 


5.68.1 Function Documentation 
5.68.1111 BOOL TelOemSmsCBIncomingInd (const Tel8msCbMsg t х pCBMsgInfo) 
This function is used to inform about an incoming cell broadcast service for GSM and UMTS. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* Refer to Cell Broadcast Service 3GPP TS 23.041 

* Re-assembling of CB Pages will not be handled in Telephony Framework 
Warning: 

* None. 


Parameters: 


< pCBMsglInfo • Defines a cell broadcast message. 


Async Response Message: 
* NA 
Returns: 


Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Prospective Clients: 


OEM Adaptation Layer. 
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5.69 TelOemSmsIncomingInd 


Functions 


e BOOL TelOemSmsIncomingInd (const Tel8msDatapackagelInfo t «pDataPackage) 


This function is used to inform about an incoming normal SMS. SMS-DELIVER message structure should 
be in TPDU format as specified by 3GPP TS 23.040 SMS TPDU. 


5.69.1 Function Documentation 
5.69.1.1 BOOL TelOemSmsIncomingInd (const TelSmsDatapackagelInfo t х pDataPackage) 


This function is used to inform about an incoming normal SMS. SMS-DELIVER message structure should 
be in TPDU format as specified by 3GPP TS 23.040 SMS TPDU. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* None 
Warning: 
* None. 


Parameters: 


< pDataPackage • SMS-DELIVER message structure. it contains string pointer field and length 
field of the message Message byte stream should be interpreted as per 3GPP TS 23.040 SMS 
TPDU 


Async Response Message: 
* МА 
Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.70 TelOemSmsMemoryStatusInd 


Functions 


* BOOL TelOemSmsMemoryStatusInd (BOOL bStatus) 


This function is used to inform the memory status i.e EF-SMS memory is Full or available, to the application. 


5.70.4 Function Documentation 
5.70.1.1 BOOL TelOemSmsMemoryStatusInd (BOOL bStatus) 


This function is used to inform the memory status i.e ЕЕ-5 М5 memory is Full or available, to the applica- 
tion. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


< bStatus • Specifies whether the memory is full or not. i.e TRUE denote memory is full and 
FALSE denotes memory is not full. 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None 


Returns: 
Return Type (BOOL) 


* Specifies whether the API response is success or failure . 


Prospective Clients: 


OEM Adaptation Layer. 
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5.71 NetworkServices 


Files 


file OemTapiNetwork.h 


This file defines the function prototypes for OEM layer for TAPI Network Module. 


Modules 


TelOemNwSetConfigurationReq 
TelOemNwSelectNetworkReq 
TelOemNwSearchNetworkReq 
TelOemNwGetNetworkInfoReq 
TelOemNwsSetSelectionModeReq 
TelOemNwGetSelectionModeReq 
TelOemNwCancelManualSearchReq 
TelOemNwCancelManualSelectionReq 
TelOemNwSetServiceDomainReq 
TelOemNwSetNetworkOrderReq 
TelOemNwSetNetworkModeReq 
TelOemNwSetNetworkBandReq 
TelOemNwRadioInfoInd 
TelOemNwSearchNetworkInd 
TelOemNwChangedInd 
TelOemNwSelectNetworkCnf 
TelOemNwSearchNetworkCnf 
TelOemNwGetSelectionModeCnf 
TelOemNwGetNetworkInfoCnf 
TelOemNwCancelManualSearchCnf 
TelOemNwCancelManualSelectionCnf 
TelOemNwSetNetworkOrderCnf 
TelOemNwSetNetworkModeCnf 
TelOemNwSetSelectionModeCnf 
TelOemNwSetNetworkBandCnf 
TelOemNwSetServiceDomainCnf 
TelOemNwSetConfigurationCnf 
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5.72 TelOemNwSetConfigurationReq 


Functions 


е TapiResult г TelOemNwSetConfigurationReq (const TelNetworkConfigSettings t  «pConfig- 
NetworkInfo) 


This function sets the network configuration preferences at OEM Telephony provider based on which net- 
work selection/registration/ camping has to be performed . 


5.72. Function Documentation 


5.72.1111 TapiResult t TelOemNwSetConfigurationReq (const TelNetworkConfigSettings t х 
pConfigNetworkInfo) 


This function sets the network configuration preferences at OEM Telephony provider based on which 
network selection/registration/ camping has to be performed . 


Sync (or) Async: 
-This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pConfigNetworkInfo - Contains Network information like network order, mode, service domain, 
etc. 


Async Response Message: 
-TelOemN wSetConfigurationCnf is the corresponding confirmation API. 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.73 TelOemNwSelectNetworkReq 


Functions 


• TapiResult t TelOemNwSelectNetworkReq (const TelNetworkSystemId t *pSystemId) 


This function provides information to the underlying OEM provider to select a network. 


5.73.1 Function Documentation 
5.73.1.4 TapiResult t TelOemNwSelectNetworkReq (const TelNetworkSystemlId t х pSystemId) 


This function provides information to the underlying OEM provider to select a network. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 


* OEM Telephony provider makes use of the network information provided in this API for selecting 
the network. 


Warning: 
* None. 


Parameters: 


< pSystemId -TAPI SYSTEMID S holds network system (gsm,wcdma, wifi etc), service 
type(Limited, No Service, CS Service, PS service etc), PLMN Id and system mode 


Async Response Message: 


-TelOemNwSelectNetworkCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.74 TelOemNwSearchNetworkReq 


Functions 


e TapiResult t TelOemNwSearchNetworkReq (void) 


This function requests the underlying OEM provider to manually search for available networks. 


5.74.1 Function Documentation 
5.74.1.1 TapiResult t TelOemNwSearchNetworkReq (void) 
This function requests the underlying OEM provider to manually search for available networks. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Async Response Message: 


-TelOemNwSearchNetworkCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.75 'TelOemNwGetNetworkInfoReq 


Functions 


* TapiResult t TelOemNwGetNetworkInfoReq (void) 


This function requests the underlying OEM provider for current network's status information. 


5.75.1 Function Documentation 
5.75.1.1 TapiResult t TelOemNwGetNetworkInfoReq (void) 
This function requests the underlying OEM provider for current network's status information. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 


* Network information will be received by the OEM asynchronously. 


Warning: 


* None. 


Async Response Message: 


-TelOemN wGetNetworkInfoCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.76 TelOemNwSetSelectionModeReq 


Functions 


* TapiResult t TelOemNwSetSelectionModeReq (TelNetworkSelectionMode t SelectionMode) 


This function configures network selection mode in the underlying OEM provider with options of Automatic 
selection or Manual selection based on which network selection procedure can happen. 


5.76.1 Function Documentation 


5.76.1.1 TapiResult t TelOemNwSetSelectionModeReq (TelNetworkSelectionMode t 
SelectionMode) 


This function configures network selection mode in the underlying OEM provider with options of Auto- 
matic selection or Manual selection based on which network selection procedure can happen. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 


* None. 
Warning: 
* None. 
Parameters: 
— SelectionMode - Automatic or Manual 


Async Response Message: 


• TelOemNwSetSelectionModeCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.7] TelOemNwGetSelectionModeReq 


Functions 


е TapiResult t TelOemNwGetSelectionModeReq (void) 


This function returns the currently set network selection mode in the underlying OEM provider - whether 
automatic or manual. 


5.77.4 Function Documentation 
5.77.11 TapiResult t TelOemNwGetSelectionModeReq (void) 


This function returns the currently set network selection mode in the underlying OEM provider - whether 
automatic or manual. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Async Response Message: 


* TelOemNwGetSelectionModeCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.78 TelOemNwCancelManualSearchReq 


Functions 


• TapiResult t TelOemNwCancelManualSearchReq (void) 


This function is used to cancel the manual network search and it can be called in the following scenarios a) 
When user wants to cancel already triggered Manual Search b) When user wants to cancel the registration 
of selected network from manual network list. 


5.78.1 Function Documentation 
5.78.1.1 TapiResult t TelOemNwCancelManualSearchReq (void) 


This function is used to cancel the manual network search and it can be called in the following scenarios a) 
When user wants to cancel already triggered Manual Search b) When user wants to cancel the registration 
of selected network from manual network list. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Async Response Message: 


e TelOemNwCancelManualSearchCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.79 TelOemNwCancelManualSelectionReq 


Functions 


e TapiResult t TelOemNwCancelManualSelectionReq (void) 


This function is used to cancel the manual network where user has already selected a network from the 
network list. 


5.79.1 Function Documentation 
5.79.1111 TapiResult t TelOemNwCancelManualSelectionReq (void) 


This function is used to cancel the manual network where user has already selected a network from the 
network list. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Async Response Message: 


• TelOemNwCancelManualSelectionCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.80 TelOemNwSetServiceDomainReq 


Functions 


e TapiResult t TelOemNwSetServiceDomainReq (TelNetworkServiceDomain ( ServiceDomain) 


This function provides the network service domain preference of the application. Based on service domain 
preference, OEM Telephony provider has to attach with the network for CS/PS/Both. 


5.80.4 Function Documentation 


5.80.1.1 TapiResult t TelOemNwSetServiceDomainReq (TelNetworkServiceDomain t 
ServiceDomain) 


This function provides the network service domain preference of the application. Based on service domain 
preference, OEM Telephony provider has to attach with the network for CS/PS/Both. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— ServiceDomain - CS, PS or Combined 


Async Response Message: 


-TelOemNwsSetServiceDomainCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


* Telephony server. 
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5.81 TelOemNwSetNetworkOrderReq 


Functions 


е TapiResult t TelOemNwSetNetworkOrderReq (TelNetworkMode t *pNwMode) 


This function provides the preference of network order in which the underlying OEM Telephony provider 
can select and camp on network. 


5.81.1 Function Documentation 
5.81.1111 TapiResult t TelOemNwSetNetworkOrderReq (TelNetworkMode t х pNwMode) 


This function provides the preference of network order in which the underlying OEM Telephony provider 
can select and camp on network. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pNwMode - This parameter is an pointer to an single dimensional array of size TAPI - 
NETWORK, ORDER MAX(which is defined as 5) of TelNetworkMode t type specifies the 
preferred network order for camping. 


Async Response Message: 


-TelOemNwSetNetworkOrderCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


* Telephony server. 
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5.82  TelOemNwSetNetworkModeReq 


Functions 


* TapiResult t TelOemNwSetNetworkModeReq (TelNetworkMode t NetworkMode) 


This function configures network mode in the underlying OEM provider with any of these options Automatic, 
GSM 900/1800, GSM 1900 or WCDMA. 


5.82.4 Function Documentation 
5.82.1.4 TapiResult t TelOemNwSetNetworkModeReg (TelNetworkMode t NetworkMode) 


This function configures network mode in the underlying OEM provider with any of these options Auto- 
matic, GSM 900/1800, GSM 1900 or WCDMA. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 


* None. 
Warning: 
* None. 


Parameters: 


— NetworkMode - This is of type TelNetworkMode_t and can take Automatic, GSM 900/1800, GSM 
1900, WCDMA, WLAN etc 


Async Response Message: 


-TelOemNwSetNetworkModeCnf is the corresponding confirmation API. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.83 TelOemNwSetNetworkBandReq 


Functions 


• TapiResult t TelOemNwSetNetworkBandReq (TelNetworkBandPreferred t BandPref, TelNetwork- 
Вара t Band) 


This function is invoked to enable or disable power on attach. 


5.83.1 Function Documentation 


5.83.1.1 TapiResult t TelOemNwSetNetworkBandReg (TelNetworkBandPreferred t BandPref, 
TelNetworkBand, t Band) 


This function is invoked to enable or disable power on attach. 


Sync (or) Async: 


-This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< BandPref - This is of type TelNetworkBandPreferred t and defines the operations that can be done 
on network Band. 


— Band - This is of type TelNetworkBand t and defines the different network Bands. 
Async Response Message: 


-TelOemN wSetNetworkBandCnf is the corresponding confirmation АРТ. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


Telephony server. 
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5.84 TelOemNwRadioInfoInd 


Functions 


e BOOL TelOemNwRadioInfoInd (const TelNetworkRadioInfo_t «pRadioInfo) 


This function is an Indication from the OEM provider of the Radio information. 


5.84.1 Function Documentation 
5.84.1.1 BOOL TelOemNwRadioInfoInd (const TelNetworkRadioInfo t х pRadioInfo) 
This function is an Indication from the OEM provider of the Radio information. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pRadioInfo -Contains network radio information 


Async Response Message: 
-NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.855 TelOemNwSearchNetworkInd 


Functions 


e BOOL TelOemNwSearchNetworkInd (const TelNetworkList t *pNetworkList) 


This function is an Indication from the OEM provider after a network search without any request from 
Telephony Server for Manual search. 


5.85.1 Function Documentation 
5.85.1.1 BOOL TelOemNwSearchNetworkInd (const TelNetworkList (ж pNetworkList) 


This function is an Indication from the OEM provider after a network search without any request from 
Telephony Server for Manual search. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pNetworkList - Contains network list 
Async Response Message: 
-NA 


Pre Conditions: 


* Search mode is set to Manual Network selection. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.86 TelOemNwChangedInd 


Functions 


e BOOL TelOemNwChangedInd (const TelNetworkInfo_t xpNetworkInfo) 


This function is used to indicate the any change in network selection/registration in the modem. As Modem 
has its own Automatic Network selection procedures due to which there can be change in currently camped 
network and service level based on signal strength etc. If there is a change in network information, Modem 
can automatically trigger this API with all the network information. 


5.86.1 Function Documentation 
5.86.1.1 BOOL TelOemNwChangedInd (const TelNetworkInfo t х pNetworkInfo) 


This function is used to indicate the any change in network selection/registration in the modem. As Modem 
has its own Automatic Network selection procedures due to which there can be change in currently camped 
network and service level based on signal strength etc. If there is a change in network information, Modem 
can automatically trigger this API with all the network information. 


Sync (or) Async: 
-This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pNetworkInfo - Contains registered Network information like network name, PLMN information, 
service domain(CS/PS/BOTH), network mode(3G/GSM) which UE is currently camped, service 
level(no service/emergency service, full service). 


Async Response Message: 
-NA 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.87 TelOemNwSelectNetworkCnf 


Functions 


e BOOL TelOemNwSelectNetworkCnf (const TelNetworkInfo t »*pNetworkInfo, TelNetwork- 
OperationCause t OpCause) 


This function is used to send the confirmation for setting the configuration at the lower layers. 


5.871 Function Documentation 


5.87.11 BOOL TelOemNwSelectNetworkCnf (const TelNetworkInfo t x pNetworkInfo, 
TelNetworkOperationCause t OpCause) 


This function is used to send the confirmation for setting the configuration at the lower layers. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pNetworkInfo - Network information. 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwsSelectNetworkReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.88 TelOemNwSearchNetworkCnf 


Functions 


e BOOL TelOemNwSearchNetworkCnf (const TelNetworkList t «pNetworkList, TelNetwork- 
OperationCause t OpCause) 


This function requests the underlying OEM provider to manually search for available networks and present 
the network list to the user. 


5.88.1 Function Documentation 


5.88.11 BOOL TelOemNwSearchNetworkCnf (const TelNetworkList t х pNetworkList, 
TelNetworkOperationCause t OpCause) 


This function requests the underlying OEM provider to manually search for available networks and present 
the network list to the user. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pNetworkList - Contains network list details. 
— OpCause - Operation cause value 

Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwSearchNetworkReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.89 TelOemNwGetSelectionModeCnf 


Functions 


e BOOL TelOemNwGetSelectionModeCnf (TelNetworkSelectionMode t SelectionMode, Tel- 
NetworkOperationCause t OpCause) 


This functions sends a confirmation for the get network selection mode request. 


5.891 Function Documentation 


5.89.1111 BOOL TelOemNwGetSelectionModeCnf (TelNetworkSelectionMode t SelectionMode, 
TelNetworkOperationCause t OpCause) 


This functions sends a confirmation for the get network selection mode request. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 
Parameters: 


— SelectionMode - Network selection mode - Automatic or manual. 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwGetSelectionModeReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.90 TelOemNwGetNetworkInfoCnf 


Functions 


e BOOL TelOemN wGetNetworkInfoCnf (const TelNetworkInfo t *pNetworkInfo, TelNetwork- 
OperationCause t OpCause) 


This function used to send a response for the get network info request. 


5.90.1 Function Documentation 


5.90.1.1 BOOL TelOemNwGetNetworkInfoCnf (const TelNetworkInfo t х pNetworkInfo, 
TelNetworkOperationCause t OpCause) 


This function used to send a response for the get network info request. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 


* None. 
Warning: 

* None. 
Parameters: 


< pNetworkInfo - Network information. 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwGetNetworkInfoReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.91 TelOemNwCancelManualSearchCnf 


Functions 


* BOOL TelOemNwCancelManualSearchCnf (TelNetworkOperationCause t OpCause) 


This function sends a confirmation for the cancel select network request. 


5.91.1 Function Documentation 
5.91.11 BOOL TelOemNwCancelManualSearchCnf (TelNetworkOperationCause t OpCause) 
This function sends a confirmation for the cancel select network request. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwCancelManualSearchReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.9) TelOemNwCancelManualSelectionCnf 


Functions 


* BOOL TelOemNwCancelManualSelectionCnf (TelNetworkOperationCause t OpCause) 


This function sends a confirmation for the cancel manual network selection request. 


5.92.1 Function Documentation 
5.92.1.1 BOOL TelOemNwCancelManualSelectionCnf (TelNetworkOperationCause t OpCause) 
This function sends a confirmation for the cancel manual network selection request. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwCancelManualSelectionReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.93 TelOemNwSetNetworkOrderCnf 


Functions 


• BOOL TelOemNwSetNetworkOrderCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network order. 


5.93.1 Function Documentation 
5.93.1.1 BOOL TelOemNwSetNetworkOrderCnf (TelNetworkOperationCause t OpCause) 
This function is a response from the OEM provider for setting the network order. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwSetNetworkOrderReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.94 TelOemNwSetNetworkModeCnf 


Functions 


• BOOL TelOemNwSetNetworkModeCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network Mode. 


5.94.1 Function Documentation 
5.94.1.1 BOOL TelOemNwSetNetworkModeCnf (TelNetworkOperationCause t OpCause) 
This function is a response from the OEM provider for setting the network Mode. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request АРІ TelOemNwSetNetworkModeReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.95 TelOemNwSetSelectionModeCnf 


Functions 


• BOOL TelOemNwSetSelectionModeCnf (TelNetworkOperationCause t OpCause) 


This functions sends a confirmation for the set network selection mode request. 


5.95.1 Function Documentation 
5.95.1.1 BOOL TelOemNwSetSelectionModeCnf (TelNetworkOperationCause_t OpCause) 
This functions sends a confirmation for the set network selection mode request. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request АРІ TelOemNwSetSelectionModeReg should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.96 TelOemNwSetNetworkBandCnf 


Functions 


• BOOL TelOemNwSetNetworkBandCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network Band. 


5.96.1 Function Documentation 
5.96.1.1 BOOL TelOemNwSetNetworkBandCnf (TelNetworkOperationCause_t OpCause) 
This function is a response from the OEM provider for setting the network Band. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwSetNetworkBandReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.97 TelOemNwSetServiceDomainCnf 


Functions 


• BOOL TelOemNwsSetServiceDomainCnf (TelNetworkOperationCause t OpCause) 


This function used to send a confirmation for setting service domain at the lower layers. 


5.97.1 Function Documentation 
5.97.1.1 BOOL TelOemNwSetServiceDomainCnf (TelNetworkOperationCause t OpCause) 
This function used to send a confirmation for setting service domain at the lower layers. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwSetServiceDomainReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.98 TelOemNwSetConfigurationCnf 


Functions 


• BOOL TelOemNwSetConfigurationCnf (TelNetworkOperationCause_t OpCause) 


This function is used to send the confirmation for setting the configuration at the lower layers. 


5.98.1 Function Documentation 
5.98.1.1 BOOL TelOemNwSetConfigurationCnf (TelNetworkOperationCause t OpCause) 
This function is used to send the confirmation for setting the configuration at the lower layers. 


Sync (or) Async: 


-This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— OpCause - Operation cause value 


Async Response Message: 
-NA 


Pre Condition: 


Request API TelOemNwSetConfigurationReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure 


Prospective Clients: 


OEM Adaptation Layer. 
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5.99 SIMServices 


Files 


* file OemTapiSim.h 
This file defines the function prototypes for OEM layer for TAPI SIM Module. 


Modules 


TelOemSimChangePINReq 
TelOemSimVerifyPINReq 
TelOemSimUnblockPINReq 
TelOemSimEnablePINReq 
TelOemSimDisablePINReq 
TelOemSimGetFileInfoReq 
TelOemSimReadFileReq 
TelOemSimUpdateFileReq 
TelOemSimEnableFDNReq 
TelOemSimDisableFDNReq 
TelOemSimGetPINInfoReq 
TelOemSimPbGetStorageCountReq 
TelOemSimPbGetEntryInfoReq 
TelOemSimPbReadRecordReq 
TelOemSimPbUpdateRecordReq 
TelOemSimPbDeleteRecordReq 
TelOemSimChangePINCnf 
TelOemSimVerifyPINCnf 
TelOemSimUnblockPINCnf 
TelOemSimEnablePINCnf 
TelOemSimDisablePINCnf 
TelOemSimGetFileInfoCnf 
TelOemSimReadFileCnf 
TelOemSimUpdateFileCnf 
TelOemSimEnableFDNCnf 
TelOemSimDisableFDNCnf 
TelOemSimGetPINInfoCnf 
TelOemSimPbGetStorageCountCnf 
TelOemSimPbGetEntryInfoCnf 
TelOemSimPbReadRecordCnf 
TelOemSimPbUpdateRecordCnf 
TelOemSimPbDeleteRecordCnf 
TelOemSimCardStatusInd 
TelOemSimCardTypeInd 
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5.100 TelOemSimChangePINReq 


Functions 


е TapiResult t TelOemSimChangePINReq (TelSimPinType t PinType, const char «pOldPinData, 
const char *pNewPinData, int RequestId) 


This function changes PIN1 or PIN2 code based on the pin type passed along with old pin data and new pin 
data. 


5.100.1 Function Documentation 


5.100.1.1  TapiResult t TelOemSimChangePINReq (TelSimPinType t PinType, const char ж 
pOldPinData, const char х pNewPinData, int RequestId) 


This function changes PIN1 or PIN2 code based on the pin type passed along with old pin data and new 
pin data. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


• TelOemSimChangePINCnf is the asynchronous response for this request. 


Warning: 
* None. 


Parameters: 


< PinType | * SIM PIN type information. 
< pOldPinData • Old pin code, entered by the user. (Null terminated string) 
< pNewPinData • New pin code, entered by the user. (Null terminated string) 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
0 to 255. Invalid request id has value -1) 
Async Response Message: 


* МА 


Pre Conditions: 

* PINI/PIN2 must be enabled before changing it. However, it is not applicable to PIN2 in case it 
is mapped to the PIN2 of GSM application as it can not be enabled or disabled. (Also, PIN2 can 
not be enabled / disabled in GSM card). 

Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.101 TelOemSimVerifyPINReq 


Functions 


• TapiResult t TelOemSimVerifyPINReq (const TelSimPinData t «pPinData, int RequestId) 


This function performs PIN verification. This function performs PIN1 or PIN2 verification based on the pin 
type passed along with current pin data. This function could be also explicitly used to retrieve the remaining 
PIN retry counter in case there is no data (PIN code) passed in the command. 


5.101.1 Function Documentation 


5.101.1.1 ТаріКеѕи t TelOemSimVerifyPINReq (const TelSimPinData t х pPinData, int 
RequestId) 


This function performs PIN verification. This function performs PIN! or PIN2 verification based on the 
pin type passed along with current pin data. This function could be also explicitly used to retrieve the 
remaining PIN retry counter in case there is no data (PIN code) passed in the command. 


Sync (or) Async: 
This is an Asynchronous API 
Important Notes: 
* TelOemSimVerifyPINCnf is the asynchronous response for this request. 
Warning: 
* None. 


Parameters: 


< pPinData • PIN code entered by the user. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 

Pre Conditions: 
* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 


* [n case of success, ТАРІ АРІ SUCCESS will be returned. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.102 TelOemSimUnblockPINReq 


Functions 


e TapiResult t TelOemSimUnblockPINReq (const TelSimPinData t *pPukPinData, const char *р- 
NewPinData, int RequestId) 


This function performs unblock РІМІ or PIN2 based on PUKI/PUK2 pin type passed along with unblock 
information passed from telephony server. 


5.1021 Function Documentation 


5.102.1.1  TapiResult t TelOemSimUnblockPINReq (const TelSimPinData t x pPukPinData, const 
char х pNewPinData, int Requestld) 


This function performs unblock PIN1 or PIN2 based on PUK1/PUK2 pin type passed along with unblock 
information passed from telephony server. 


Sync (or) Async: 
This is an Asynchronous API 
Important Notes: 
* TelOemSimUnblockPINCnf is the asynchronous response for this request. 
Warning: 
* None. 


Parameters: 


< pPukPinData • Specifies the unblocking PIN password 
< pNewPinData % Specifies the PIN password 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.103 TelOemSimEnablePINReq 


Functions 


е TapiResult t TelOemSimEnablePINReq (const TelSimPinData t *pPinData, int RequestId) 
This function enables PIN lock (Pinl ). 


5.103.1 Function Documentation 


5.103.1.1  TapiResult t TelOemSimEnablePINReq (const TelSimPinData t x pPinData, int 
RequestId) 


This function enables PIN lock (Pin1). 


Sync (or) Async: 


This is an Asynchronous API 


Important Notes: 


* TelOemSimEnablePINCnf is the asynchronous response for this request. 


Warning: 
* None. 


Parameters: 


< pPinData • User entered PIN data and PIN type. 


< Requestld — * Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.104 TelOemSimDisablePINReq 


Functions 


* TapiResult t TelOemSimDisablePINReq (const TelSimPinData t «pPinData, int RequestId) 
This function disables or unlocks the PIN(PIN1). 


5.1041 Function Documentation 


5.104.1.1  TapiResult t TelOemSimDisablePINReq (const TelSimPinData_t х pPinData, int 
RequestId) 


This function disables or unlocks the PIN(PIN1). 


Sync (or) Async: 


This is an Asynchronous API 


Important Notes: 


* TelOemSimDisablePINCnf is the asynchronous response for this request. 


Warning: 
* None. 


Parameters: 


< pPinData • User entered Pin disable data and pin type. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.105 TTelOemSimGetFileInfoReq 


Functions 


е TapiResult t TelOemSimGetFileInfoReq (const TelSimFileID t *pFileld, int RequestId) 


This function is called to pass the request to OEM telephony provider to fetch the Elementary File informa- 
tion. 


5.105.1 Function Documentation 
5.105.1.1  TapiResult t TelOemSimGetFileInfoReq (const TelSimFileID t x pFileld, int RequestId) 


This function is called to pass the request to OEM telephony provider to fetch the Elementary File infor- 
mation. 


Sync (or) Async: 


This is an Asynchronous API 


Important Notes: 


* TelOemSimGetFileInfoCnf is the asynchronous response for this request. 
Warning: 
* None. 


Parameters: 


< pFileld • File identifier for Elementary file inside SIM. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.106 TelOemSimReadFileReq 


Functions 


е TapiResult t TelOemSimReadFileReq (const TelSimReadFileRequestData t *pReadFileReqData, 
int RequestId) 


This function is called in order pass the request for reading Elementary file from SIM. 


5.106.1 Function Documentation 


5.106.1.1  TapiResult t TelOemSimReadFileReq (const TelSimReadFileRequestData t х 
pReadFileReqData, int RequestId) 


This function is called in order pass the request for reading Elementary file from SIM. 


Sync (or) Async: 


This is an Asynchronous API 


Important Notes: 


* TelOemSimReadFileCnf is the asynchronous response for this request. 
Warning: 
* None. 


Parameters: 


< pReadFileReqData • The parameters that needs to be passed for reading SIM EF 


< Requestld • Unique identifier for a particular request. (request id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.107  TelOemSimUpdateFileReq 


Functions 


• TapiResult t TelOemSimUpdateFileReq (const TelSimUpdateFileRequestData t *pUpdateFileReq- 
Data, int RequestId) 


This function is passed to OEM provider in order to update records in an Elementary file. 


5.1071 Function Documentation 


5.107.1.1 TapiResult t TelOemSimUpdateFileReq (const TelSimUpdateFileRequestData t х 
pUpdateFileReqData, int RequestId) 


This function is passed to OEM provider in order to update records in an Elementary file. 


Sync (or) Async: 


This is an Asynchronous API 


Important Notes: 

* TelOemSimUpdateFileCnf is the asynchronous response for this request. 
Warning: 

* None. 


Parameters: 


< pUpdateFileReqData • The information required to update elementary files in SIM is specified 
through this parameter. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 

Pre Conditions: 
* None. 

Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.108 TelOemSimEnableFDNReq 


Functions 


e TapiResult t TelOemSimEnableFDNReq (const char *рРіпраға, int RequestId) 
This function enables FDN at the lower layers by accepting the PIN2 information entered by the user. 


5.108.1 Function Documentation 
5.108.1.1 TapiResult_t TelOemSimEnableFDNReq (const char * pPinData, int RequestId) 


This function enables FDN at the lower layers by accepting the PIN2 information entered by the user. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 


* TelOemSimEnableFDNCnf is the asynchronous response for this request. 


Warning: 


* None. 


Parameters: 


< pPinData • User entered PIN2 data. (NULL terminated string) 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.109 TelOemSimDisableFDNReq 


Functions 


e TapiResult t TelOemSimDisableFDNReq (const char *pPinData, int RequestId) 
This function initiates disabling FDN in the lower layers with the PIN2 data entered by the user. 


5.109.1 Function Documentation 
5.109.1.1  TapiResult t TelOemSimDisableFDNReq (const char * pPinData, int RequestId) 


This function initiates disabling FDN in the lower layers with the PIN2 data entered by the user. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 


* TelOemSimDisableFDNCnf is the asynchronous response for this request. 


Warning: 


* None. 


Parameters: 


< pPinData • User entered PIN2 data. (NULL terminated string) 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 
Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ АРІ SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.110 TelOemSimGetPINInfoReq 


Functions 


* TapiResult t TelOemSimGetPINInfoReq (TelSimPinType t PinType, int RequestId) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 


5.110.1 Function Documentation 
5.110.1.1  TapiResult t TelOemSimGetPINInfoReq (TelSimPinType t Pin Type, int Кедиез 4) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 


* TelOemSimGetPINInfoCnf is the asynchronous response for this request. 
Warning: 
* None. 


Parameters: 


< PinType | * SIM PIN type information. 


< Requestld  * Unique identifier for a particular request. (request. id value can be any value from 
0 to 255. Invalid request id has value -1) 


Async Response Message: 
* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.111 TelOemSimPbGetStorageCountReq 


Functions 


e TapiResult t TelOemSimPbGetStorageCountReq  (TelSimPbFileType t StorageFileType, іш 
RequestId) 


This API is used to get number of used PB records and total records in SIM phone book files. This API is 
only applicable to GSM phonebook. 


5.1111 Function Documentation 


5.11111 TapiResult t TelOemSimPbGetStorageCountReq (TelSimPbFileType t StorageFileType, 
int Requestld) 


This API is used to get number of used PB records and total records in SIM phone book files. This API is 
only applicable to GSM phonebook. 


Sync (or) Async: 
* This is an Asynchronous API 
Important Notes: 


* TelOemSimPbGetStorageCountCnf is the asynchronous response for this request. This API is 
applicable only for 2G phonebook. 


Warning: 
* None. 


Parameters: 


< StorageFileType “ Different storage types to be selected in SIM. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 

Pre Conditions: 
* None. 


Post Conditions: 


* None. 
Returns: 


Return Type (TapiResult t) 


* [n case of success, ТАРІ АРІ SUCCESS will be returned. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.112 TelOemSimPbGetEntryInfoReq 


Functions 


* TapiResult t TelOemSimPbGetEntryInfoReq (TelSimPbFileType t StorageFileType, int Request- 
Id) 


This API is used to get max text length and max number length supported by SIM phone book files. 


5.112.1 Function Documentation 


5.112.1111 TapiResult t TelOemSimPbGetEntryInfoReq (TelSimPbFileType t StorageFileType, int 
RequestId) 


This API is used to get max text length and max number length supported by SIM phone book files. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 


* TelOemSimPbGetEntryInfoCnf is the asynchronous response for this request. This API is appli- 
cable only for 2G phonebook. 


Warning: 
* None. 


Parameters: 


< StorageFileType “ Different storage types to be selected in SIM. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
0 to 255. Invalid request id has value -1) 


Async Response Message: 
* МА 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.113 TelOemSimPbReadRecordReq 


Functions 


* TapiResult t TelOemSimPbReadRecordReq (TelSimPbFileType t StorageFileType, unsigned short 
Index, int RequestId) 


This API is used to read sim phone book entry information. A phonebook entry information consists of the 
record in EF-ADN. 


5.113.1 Function Documentation 


5.113.1.1 TapiResult t TelOemSimPbReadRecordReq (TelSimPbFileType t StorageFileType, 
unsigned short Index, int RequestId) 


This API is used to read sim phone book entry information. A phonebook entry information consists of the 
record in EF-ADN. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 
* TelOemSimPbReadRecordCnf is the asynchronous response for this request. This API is appli- 
cable only for 2G phonebook. 
Warning: 


* None. 


Parameters: 
< StorageFileType “ Different storage types to be selected in SIM. 
< Index • Index of the record to be read. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 
Async Response Message: 


* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 
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* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.114 TelOemSimPbUpdateRecordReq 


Functions 


* TapiResult t TelOemSimPbUpdateRecordReq (const TelSimPbRecordData t *pPbUpdateData, int 
RequestId) 


This API is used to add or edit sim phone book entry information. 


5.114.1 Function Documentation 


5.114.1.1 TapiResult t TelOemSimPbUpdateRecordReq (const TelSimPbRecordData t « 
pPbUpdateData, int RequestId) 


This API is used to add or edit sim phone book entry information. 


Sync (or) Async: 
* This is an Asynchronous API 


Important Notes: 


* TelOemSimPbUpdateRecordCnf is the asynchronous response for this request. This API is ap- 
plicable only for 2G phonebook. 


Warning: 
* None. 


Parameters: 


< pPbUpdateData • Specifies the information of the record to be added/edited. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* МА 

Pre Conditions: 
* None. 

Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
* [n case of success, ТАРІ API SUCCESS will be returned. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.115 TelOemSimPbDeleteRecordReq 


Functions 


* TapiResult t TelOemSimPbDeleteRecordReq (TelSimPbFileType t StorageFileType, unsigned 
short Index, int RequestId) 


This API is used for deleting a SIM phone book record. 


5.115.1 Function Documentation 


5.115.1.1 TapiResult t TelOemSimPbDeleteRecordReq (TelSimPbFileType t StorageFileType, 
unsigned short Index, int RequestId) 


This API is used for deleting a SIM phone book record. 
Sync (or) Async: 

* This is an Asynchronous API 
Important Notes: 


* TelOemSimPbDeleteRecordCnf is the asynchronous response for this request. This API is appli- 
cable only for 2G phonebook. 


Warning: 
* None. 


Parameters: 


< StorageFileType “ Different storage types to be selected in SIM. 
< Index œ Index of the record to be deleted. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 


* [n case of success, ТАРІ API SUCCESS will be returned. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


* Telephony Server 
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5.116 TelOemSimChangePINCnf 


Functions 


e BOOL TelOemSimChangePINCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimChangePINReq. 


5.116.1 Function Documentation 


5.116.1.1 BOOL TelOemSimChangePINCnf (const TelSimPinInfo t * pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimChangePINReq. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type, number of retries left etc. If opResult is other 
than SUCCESS, then pPinInfo shall be NULL. 

< OpResult • SIM operation result - operation success or failure. If failure, the exact cause for 
that. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

* TelOemSimChangePINReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.117 TelOemSimVerifyPINCnf 


Functions 


e BOOL TelOemSimVerifyPINCnf (const TelSimPinInfo t *pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimVerifyPINReq. 


5.117.1 Function Documentation 


5.117.1.4 BOOL TelOemSimVerifyPINCnf (const TelSimPinInfo (ж pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSim VerifyPINReq. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type, number of retries left etc. If opResult is other 
than SUCCESS, then pPinInfo shall be NULL. 


< OpResult • SIM operation result - operation success or failure. If failure, the exact cause for 
that. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

* TelOemSimVerifyPINReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.118 TelOemSimUnblockPINCnf 


Functions 


e BOOL TelOemSimUnblockPINCnf (const TelSimPinInfo t »*pPinInfo, TelSimPinOperation- 
Result t OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimUnblockPINReq. 


5.118.1 Function Documentation 


5.118.1.1 BOOL TelOemSimUnblockPINCnf (const TelSimPinInfo t х pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimUnblockPINReq. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type, number of retries left etc. If opResult is other 
than SUCCESS, then pPinInfo shall be NULL. 


< OpResult • SIM operation result - operation success or failure. If failure, the exact cause for 
that. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

* TelOemSimUnblockPINReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.119 TelOemSimEnablePINCnf 


Functions 


e BOOL TelOemSimEnablePINCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimEnablePINReq. 


5.119.1 Function Documentation 


5.119.1111 BOOL TelOemSimEnablePINCnf (const TelSimPinInfo_t ж pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimEnablePINReq. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type, number of retries left etc. If opResult is other 
than SUCCESS, then pPinInfo shall be NULL. 


< OpResult • SIM operation result - operation success or failure. If failure, the exact cause for 
that. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

• TelOemSimEnablePINReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.120 TelOemSimDisablePINCnf 


Functions 


e BOOL TelOemSimDisablePINCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimDisablePINReq. 


5.120.1 Function Documentation 


5.120.1.1 BOOL TelOemSimDisablePINCnf (const TelSimPinlInfo (ж pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimDisablePINReq. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type, number of retries left etc. If opResult is other 
than SUCCESS, then pPinInfo shall be NULL. 

< OpResult • SIM operation result - operation success or failure. If failure, the exact cause for 
that. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

* TelOemSimDisablePINReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.121 TelOemSimGetFileInfoCnf 


Functions 


e BOOL TelOemSimGetFileInfoCnf (const TelSimFileInfo t *pFileInfo, TelSimAccessResult - 
t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimGetFileInfoReq. 


5.121.1 Function Documentation 


5.121.1.1 BOOL TelOemSimGetFileInfoCnf (const TelSimFileInfo t х pFileInfo, 
TelSimA ccessResult t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimGetFileInfoReq. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pFilelnfo | * Read elementary file information from SIM. If opResult is other than SUCCESS, 
then pFileInfo shall be NULL. 


< AccessResult | * SIM card access result - Success otherwise cause for failure. 


< Requestld “ Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* МА 
Pre Conditions: 

* TelOemSimGetFileInfoReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


146 Module Documentation 


5.122 TelOemSimReadFileCnf 


Functions 


e BOOL TelOemSimReadFileCnf (const TelSimReadFileData t *xpReadData, TelSimAccessResult t 
AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimReadFileReq. 


5.122.1 Function Documentation 


5.122.1.1 BOOL TelOemSimReadFileCnf (const TelSimReadFileData t х pReadData, 
TelSimA ccessResult t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimReadFileReq. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pReadData | * This data structure contains the raw elementary file information, read from SIM. 
This structure will be Null in case of error. 


< AccessResult | * SIM card access result - Success otherwise cause for failure. 


< Requestld “ Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* МА 
Pre Conditions: 

* TelOemSimReadFileReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.123 TelOemSimUpdateFileCnf 


Functions 


• BOOL TelOemSimUpdateFileCnf (const TelSimFileAccessGeneralResp_t *pUpdateData, TelSim- 
AccessResult. t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimUpdateFileReq. 


5.123.1 Function Documentation 


5.123.1.1 BOOL TelOemSimUpdateFileCnf (const TelSimFileAccessGeneralResp t х 
pUpdateData, TelSimAccessResult_t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimUpdateFileReq. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pUpdateData • This data structure contains the result of update operation, file id etc. If opResult 
is other than SUCCESS, then pUpdateData shall be NULL. 


< AccessResult | * SIM card access result - Success otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* МА 
Pre Conditions: 

* TelOemSimUpdateFileReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.124 TelOemSimEnableFDNCnf 


Functions 


• BOOL TelOemSimEnableFDNCnf (TelSimPinOperationResult t OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimEnableFDNReq. 


5.124.1 Function Documentation 


5.12411 BOOL TelOemSimEnableFDNCnf (TelSimPinOperationResult t OpResult, int 
RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimEnableFDNReq. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< OpResult — * PIN operation result - Success or the cause of failure If successful, opResult will 
be TAPI SIM PIN OPERATION SUCCESS. If PIN2 is incorrect, then opResult will be 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS. If PUK2 is incorrect, then op- 
Result will be TAPI SIM PUK INCORRECT PASSWORD STATUS. 


< Requestld  * Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 
Pre Conditions: 


* TelOemSimEnableFDNReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.125 TelOemSimDisableFDNCnf 


Functions 


* BOOL TelOemSimDisableFDNCnf (TelSimPinOperationResult t OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimDisableFDNReq. 


5.125.1 Function Documentation 


5.125.1.1 BOOL TelOemSimDisableFDNCnf (TelSimPinOperationResult t OpResult, int 
RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimDisableFDNReq. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< OpResult — * PIN operation result - Success or the cause of failure If successful, opResult will 
be TAPI SIM PIN OPERATION SUCCESS. If PIN2 is incorrect, then opResult will be 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS. If PUK2 is incorrect, then op- 
Result will be TAPI SIM PUK INCORRECT PASSWORD STATUS. 


< Requestld  * Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 
Pre Conditions: 


* TelOemSimDisableFDNReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.126 TelOemSimGetPINInfoCnf 


Functions 


e BOOL TelOemSimGetPINInfoCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 


5.126.1 Function Documentation 


5.126.1.1 BOOL TelOemSimGetPINInfoCnf (const TelSimPinInfo t ж pPinInfo, 
TelSimPinOperationResult t OpResult, int RequestId) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPinInfo | * SIM PIN information like PIN type and number of retries left. If opResult is other 
than PIN SUCCESS, then pPinInfo shall be Null. 


< OpResult • PIN operation result - operation success or failure error cause 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* МА 
Pre Conditions: 

* TelOemSimGetPINInfoReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.127 TelOemSimPbGetStorageCountCnf 151 


5.127 TelOemSimPbGetStorageCountCnf 


Functions 


e BOOL TelOemSimPbGetStorageCountCnf (const TelSimPbStorageInfo t *pStorageInfo, TelSim- 
AccessResult_t PbAccessResult, int RequestId) 


This function is called to send a confirmation to the upper layers for the TelOemSimPbGetStorage CountReq 
API. 


5.127.1 Function Documentation 


5.127.1.1 BOOL TelOemSimPbGetStorageCountCnf (const TelSimPbStorageInfo (ж 
pStorageInfo, TelSimAccessResult t PbAccessResult, int RequestId) 


This function is called to send a confirmation to the upper layers for the TelOemSimPbGetStorageCount- 
Req API. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pStoragelnfo • GSM phone book entry information like EF file type, total record count and 
used record count. If pbAccessResult is other than SUCCESS, then pStorageInfo shall be 
NULL. 


— PbAccessResult | * Phone book access result - Success or otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* TelOemSimPbGetStorageCountReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


152 Module Documentation 


Prospective Clients: 


* OEM Adaptation Layer 
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5.128 TelOemSimPbGetEntryInfoCnf 


Functions 


• BOOL TelOemSimPbGetEntryInfoCnf (const TelSimPbEntryInfo t *pPbEntryInfo, TelSimAccess- 
Result. t PbAccessResult, int RequestId) 


This API is used to get max text length and max number length supported by SIM phone book files. This 
function is called to send a confirmation to the upper layers for TelOemSimPbGetEntryInfoReq API. 


5.128.1 Function Documentation 


5.128.1.1 BOOL TelOemSimPbGetEntryInfoCnf (const TelSimPbEntryInfo t х pPbEntryInfo, 
TelSimA ccessResult t PbAccessResult, int RequestId) 


This API is used to get max text length and max number length supported by SIM phone book files. This 
function is called to send a confirmation to the upper layers for TelOemSimPbGetEntryInfoReq API. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPbEntryInfo • Phone book entry information like maximum length of text supported, maxi- 
mum and minimum index of GSM phone book. If pbAccessResult is other than SUCCESS, 
then pPbEntryInfo shall be NULL. 


— PbAccessResult | * Phone book access result - Success or otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* TelOemSimPbGetEntryInfoReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 
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Prospective Clients: 


* OEM Adaptation Layer 
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5.129 TelOemSimPbReadRecordCnf 


Functions 


• BOOL TelOemSimPbReadRecordCnf (const TelSimPbRecordData t «pPbReadResponse, TelSim- 
AccessResult_t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbReadRecordReq API. 


5.129.1 Function Documentation 


5.129.1.1 BOOL TelOemSimPbReadRecordCnf (const TelSimPbRecordData t х 
pPbReadResponse, TelSimAccessResult t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbReadRecordReq API. 
Sync (or) Async: 
* This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPbReadResponse • GSM phone book read response like SIM file type, 2G phone book record 
data, encryption type used etc. If pbAccessResult is other than SUCCESS, then pPbRead- 
Response shall be NULL. 


— PbAccessResult | * Phone book access result - Success or otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* NA 
Pre Conditions: 

* TelOemSimPbReadRecordReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.130 TelOemSimPbUpdateRecordCnf 


Functions 


• BOOL TelOemSimPbUpdateRecordCnf (const TelSimPbUpdateResp t *pPbUpdateResp, TelSim- 
AccessResult, t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbUpdateRecordReq API. 


5.130.1 Function Documentation 


5.130.11 BOOL TelOemSimPbUpdateRecordCnf (const TelSimPbUpdateResp (ж 
pPbUpdateResp, TelSimA ccessResult t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbUpdateRecordReq API. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPbUpdateResp | * GSM phone book update response. If pbAccessResult is other than SUC- 
CESS, then pPbUpdateResp shall be NULL. 


— PbAccessResult | * Phone book access result - Success or otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 

* МА 
Pre Conditions: 

* TelOemSimPbUpdateRecordReq should be called in prior. 
Post Conditions: 

* None. 


Returns: 


BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.131 TelOemSimPbDeleteRecordCnf 157 


5.131 TelOemSimPbDeleteRecordCnf 


Functions 


e BOOL TelOemSimPbDeleteRecordCnf (const TelSimPbUpdateResp t *pPbDeleteResp, TelSim- 
AccessResult, t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbDeleteRecordReq API. 


5.131.1 Function Documentation 


5.131.1.1 BOOL TelOemSimPbDeleteRecordCnf (const TelSimPbUpdateResp t * pPbDeleteResp, 
TelSimA ccessResult t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbDeleteRecordReq API. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pPbDeleteResp • GSM phone book delete response. 
— PbAccessResult | * Phone book access result - Success or otherwise cause for failure. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 
* NA 


Pre Conditions: 


* TelOemSimPbDeleteRecordReq should be called in prior. 
Post Conditions: 
* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.132 TelOemSimCardStatusInd 


Functions 


* BOOL TelOemSimCardStatusInd (TelSimCardStatus, t CardStatus) 


This function sends the indication to the upper layers regarding the SIM card status during SIM Initialization 
or Card not present/ Card gone bad / Card Blocked(both Pin and PUK blocked). 


5.132.1 Function Documentation 
5.132.1.1 BOOL TelOemSimCardStatusInd (TelSimCardStatus t CardStatus) 


This function sends the indication to the upper layers regarding the SIM card status during SIM Initializa- 
tion or Card not present/ Card gone bad / Card Blocked(both Pin and PUK blocked). 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 

* None. 
Warning: 

* None. 
Parameters: 

— CardStatus • SIM card status. 

Async Response Message: 

* МА 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.133 TelOemSimCardTypelInd 


Functions 


e BOOL TelOemSimCardTypelnd (TelSimCardType t CardType) 
This function sends the indication to the upper layers regarding the SIM card type at the time of boot-up. 


5.133.1 Function Documentation 
5.133.1.1 BOOL TelOemSimCardTypelnd (TelSimCardType t CardType) 
This function sends the indication to the upper layers regarding the SIM card type at the time of boot-up. 


Sync (or) Async: 
* This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< CardType | * SIM card type (GSM/USIM/Unknown) 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
BOOL 


* Specifies whether the API response is success or failure. 


Prospective Clients: 


* OEM Adaptation Layer 
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5.134  SSServices 


Files 


file OemTapiSS.h 


This file defines the function prototypes for OEM layer for TAPI SS Module. 


Modules 


TelOemSsSetCallBarringReq 
TelOemSsChangeBarPasswordReq 
TelOemSsGetCallBarringStatusReq 
TelOemSsSetCallForwardReq 
TelOemSsGetCallForwardStatusReq 
TelOemSsSetCall WaitingReq 
TelOemSsGetCall WaitingStatusReq 
TelOemSsSendUssdReq 
TelOemSsQueryCapabilityInfoReq 
TelOemSsSendUssdUserRsp 
TelOemSs VerifyBarPwdRsp 
TelOemSsSetCallBarringCnf 
TelOemSsChangeBarPass wordCnf 
TelOemSsGetCallBarringStatusCnf 
TelOemSsSetCallForwardCnf 
TelOemSsGetCallForwardStatusCnf 
TelOemSsSetCall WaitingCnf 
TelOemSsGetCall WaitingStatusCnf 
TelOemSsSendUssdCnf 
TelOemSsUssdInd 
TelOemSsQueryCapabilityInfoCnf 
TelOemSsGetPwdInd 
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5.135 TelOemSsSetCallBarringReq 


Functions 


е TapiResult t TelOemSsSetCallBarringReq (const TelSsCallBarringInfo t *pBarInfo, int Request- 
Id) 


This function requests lower layers to activate/deactivate Call Barring depends on the barring type (incom- 
ing or outgoing) on NW side. 


5.135.1 Function Documentation 


5.135.1.1 TapiResult t TelOemSsSetCallBarringReq (const TelSsCallBarringInfo t * pBarInfo, 
int RequestlId) 


This function requests lower layers to activate/deactivate Call Barring depends on the barring type (incom- 
ing or outgoing) on NW side. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


For this request, there can be intermediate operations. Incase of Network interrogation for barring 
password for this request, then TelOemSsGetPwdlInd function will be called. Barring Password re- 
sponse will be sent using TelOemSsVerifyBarPwdRsp . Finally TelOemSsSetCallBarringCnf function 
will be called by OEM to send the barring confirmation response to the telephony server. 

Warning: 


* None. 


Parameters: 


< pBarInfo • All the required parameters (basic service group, call forward number, no reply 
time, forward condition etc) for call forwarding operation. 


< Requestld • Unique identifier for a particular request. 
e (requestId value can be any value from 0 to 255. Invalid requestlId has value -1). 


Async Response Message: 


TelOemSsSetCallBarringCnf () Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.136 TelOemSsChangeBarPasswordReq 


Functions 


e TapiResult t TelOemSsChangeBarPasswordReq (const char *pOldPassword, const char жрМеуу- 
Password) 


This function requests lower layers to change the call barring password stored in NW to a new password. 


5.136.1 Function Documentation 


5.136.1.1 TapiResult t TelOemSsChangeBarPasswordReq (const char ж pOldPassword, const char 
* pNewPassword) 


This function requests lower layers to change the call barring password stored in NW to a new password. 
Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


TelOemSsChangeBarPasswordCnf function will be used to send the response to the telephony server. 
OEM should only allow one such request at a time and return ТАРІ АРІ REQUEST МАХ IN - 
PROGRESS if another request is received. 


Warning: 
* None. 


Parameters: 


< pOldPassword | * Call barring old password stored in NW (NULL terminated string). 
< pNewPassword • Call barring new password to be stored in NW for call barring procedure 
(NULL terminated string). 


Async Response Message: 


TelOemSsChangeBarPasswordCnf () Api will be used to send the confirmation with a status of Success 
or failure. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.137 TelOemSsGetCallBarringStatusReq 


Functions 


* TapiResult t TelOemSsGetCallBarringStatusReq (TelSsCallBarType t BarType, TelSsCallType - 
t Call Type, int RequestId) 


This function requests lower layers to fetch the Call Barring status from NW. 


5.137.1 Function Documentation 


5.137.1.1 TapiResult t TelOemSsGetCallBarringStatusReq (TelSsCallBarType t BarType, 
TelSsCallType t CallType, int RequestId) 


This function requests lower layers to fetch the Call Barring status from NW. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
TelOemSsGetCallBarringStatusCnf function will be used to send the response to the telephony server. 
Warning: 
* None. 


Parameters: 


< BarType % Provides the barring type (e.g. Incoming or outgoing etc). 
< CallType ” Type of call (voice, data.). 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1). 


Async Response Message: 


TelOemSsGetCallBarringStatusCnf Api will be used to send the confirmation with a status of Success 
or failure. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 


е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.138  TelOemSsSetCallForwardReq 


Functions 


е TapiResult t TelOemSsSetCallForwardReq (const TelSsForwardInfo t «pCallFwdInfo, int Request- 
Id) 


This function passes Register/Activate/Deactivate/Erase Call Forward request to low layers. This service 
permits a called mobile subscriber to have the network send all incoming calls (speech and data) which 
meet various call FORWARD condition to another directory number. Various conditions are busy, not 
reachable, not answering, and unconditional. The ability of the served mobile subscriber to originate calls 
is unaffected. If the service is activated, a call is forwarded only if under this call FORWARD condition. 


5.138.1 Function Documentation 


5.138.1.1  TapiResult t TelOemSsSetCallForwardReq (const TelSsForwardInfo t х pCallFwdInfo, 
int Requestld) 


This function passes Register/Activate/Deactivate/Erase Call Forward request to low layers. This service 
permits a called mobile subscriber to have the network send all incoming calls (speech and data) which 
meet various call FORWARD condition to another directory number. Various conditions are busy, not 
reachable, not answering, and unconditional. The ability of the served mobile subscriber to originate calls 
is unaffected. If the service is activated, a call is forwarded only if under this call FORWARD condition. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


TelOemSsSetCallForwardCnf function will be used to send the response to the telephony server. 


Warning: 


* None. 


Parameters: 


< pCallFwdInfo — * all the required parameters (basic service group, call forward number, по reply 
time, forward condition etc) for call forwarding operation . 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1). 


Async Response Message: 


TelOemSsSetCallForwardCnf () Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.139 TelOemSsGetCallForwardStatusReq 


Functions 


* TapiResult t TelOemSsGetCallForwardStatusReq (TelSsForwardType t FwdType, TelSsForward- 
When, t Condition, int RequestId) 
This function requests Call Forwarding status from NW. 


5.139.1 Function Documentation 


5.139.1.1  TapiResult t TelOemSsGetCallForwardStatusReq (TelSsForwardType t FwdType, 
TelSsForwardWhen t Condition, int RequestId) 


This function requests Call Forwarding status from NW. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
TelOemSsGetCallForwardStatusCnf function will be used to send the response to the telephony server.. 
Warning: 
* None. 


Parameters: 


< FwdType “% Specifies the forward call type, i.e. Voice, data. 


< Condition • Used to specify the forward condition i.e. unconditional, When no reply, when 
busy, when not reachable etc.). 


< Requestld “ Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1) 


Async Response Message: 


TelOemSsGetCallForwardStatusCnf () Api will be used to send the confirmation with a status of Suc- 
cess or failure. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.140 TelOemSsSetCallWaitingReq 


Functions 


e TapiResult t TelOemSsSetCallWaitingReq (BOOL bCwStatus, int RequestId) 


This function passes requests to activate/deactivate call waiting on NW side for all applicable basic services. 


5.140.1 Function Documentation 
5.140.1.1  TapiResult t TelOemSsSetCallWaitingReq (BOOL bCwStatus, int RequestId) 
This function passes requests to activate/deactivate call waiting on NW side for all applicable basic services. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


TelOemSsSetCallWaitingCnf function will be used to send the response to the telephony server. 


Warning: 
* None. 


Parameters: 


< bCwStatus • Enable or Disable mode. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1). 
Async Response Message: 


TelOemSsSetCallWaitingCnf () Api will be used to send the confirmation with a status of Success or 
failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.141 TelOemSsGetCallWaitingStatusReq 


Functions 


* TapiResult t TelOemSsGetCallWaitingStatusReq (int RequestId) 


This function requests lower layer to interrogate Call Waiting status on NW side. 


5.141.1 Function Documentation 
5.141.1.1 TapiResult t TelOemSsGetCallWaitingStatusReq (int RequestId) 
This function requests lower layer to interrogate Call Waiting status on NW side. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


TelOemSsGetCallWaitingStatusCnf function will be used to send the response to the telephony server. 


Warning: 


* None. 


Parameters: 
< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
Ото 255. Invalid request id has value -1). 
Async Response Message: 
TelOemSsGetCallWaitingStatusCnf () Api will be used to send the confirmation with a status of Suc- 
cess or failure. 
Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.142 TelOemSsSendUssdReq 


Functions 


е TapiResult t TelOemSsSendUssdReq (const TelSsUssdMsgInfo t *pUssdMsgInfo) 
This API triggers the underlying Supplementary service protocol to send the USSD data to the network. 


5.142.1 Function Documentation 
5.142.1.4  TapiResult t TelOemSsSendUssdReq (const TelSsUssdMsgInfo t x pUssdMsgInfo) 
This API triggers the underlying Supplementary service protocol to send the USSD data to the network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


If there is any intermediate USSD session requested by network, then Telephony provider will make 
use of TelOemSsSendUssdInd API. TelOemSsSendUssdCnf function will be used to send the final 
confirmation to the telephony server once the USSD session is complete 


Warning: 
* None. 


Parameters: 


< pUssdMsgInfo — * Structure holds USSD Data information.. 


Async Response Message: 


TelOemSsSendUssdCnf () Api will be used to send the confirmation with a status of Success or failure. 


Pre Conditions: 
* Incase if already one USSD session exist, then appropriate error will be returned to the client ie., 
There cannot be a USSD request at the same time as a call independent SS operation.. 
Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.143  TelOemSsQueryCapabilityInfoReq 


Functions 


* TapiResult t TelOemSsQueryCapabilityInfoReq () 


This function interrogates about the available supplementary services at lower layers. 


5.143.1 Function Documentation 
5.143.1.1 TapiResult t TelOemSsQueryCapabilityInfoReq О 


This function interrogates about the available supplementary services at lower layers. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


TelOemSsQueryCapabilityInfoCnf function will be used to send the response to the telephony server. 


Warning: 


* None. 


Async Response Message: 


TelOemSsQueryCapabilityInfoCnf () Api will be used to send the confirmation with a status of Success 
or failure. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.144 TelOemSsSendUssdUserRsp 


Functions 


е TapiResult t TelOemSsSendUssdUserRsp (const TelSsUssdMsgInfo t *pUssdMsgInfo, TelSs- 
Cause. t Cause) 
This function sends the response for the USSD indication . 


5.144.1 Function Documentation 


5.14411  TapiResult t TelOemSsSendUssdUserRsp (const TelSsUssdMsglInfo t ж pUssdMsgInfo, 
TelSsCause t Cause) 


This function sends the response for the USSD indication . 
Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


If cause value is other than "ТАРІ SS OPERATION SUCCESS", pUssdMsgInfo will be "NULL" 
and underlying modem can close the USSD Session. 


Warning: 
* None. 


Parameters: 


< pUssdMsgInfo • Structure holds USSD Data information like whether any user acknowledge- 
ments, what encoding used for USSD Data , USSD Data length and USSD data 
* USSD Response and Indication type will be present in the response. 
< Cause • Describes whether a supplementary service indication was successfully processed by 
an application or a failure reason 


Async Response Message: 
None 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.145 TelOemSsVerifyBarPwdRsp 173 


5.145 TelOemSsVerifyBarPwdRsp 


Functions 


е TapiResult t TelOemSsVerifyBarPwdRsp (const char *pBarringPwd) 


This function provides a response to a get password indication which was requested by the network through 
TelOemSsGetPwdlnd . 


5.145.1 Function Documentation 
5.145.1.1 TapiResult t TelOemSsVerifyBarPwdRsp (const char х pBarringPwd) 


This function provides a response to a get password indication which was requested by the network through 
TelOemSsGetPwdlInd . 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
None. 
Warning: 
* None. 


Parameters: 


< pBarringPwd — * Call barring password, a null terminated ASCII String. 


Async Response Message: 
* None. 


Pre Conditions: 


е TelOemSsGetPwdlInd should have been called. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* [n case of failure, error code will be returned. (Refer TapiResult t). 


Prospective Clients: 


Telephony Server. 
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5.146 TelOemSsSetCallBarringCnf 


Functions 


e BOOL TelOemSsSetCallBarringCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int Request- 
Id) 


This function gives the response of TelOemSsSetCallBarringReq to the upper layers, from the network. 


5.146.1 Function Documentation 


5.146.1.4 BOOL TelOemSsSetCallBarringCnf (TelSsCause t Cause, const TelSsInfo t ж pSsInfo, 
int Requestld) 


This function gives the response of TelOemSsSetCallBarringReq to the upper layers, from the network. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


Warning: 


* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 


< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


< Requestld • Unique identifier for a particular request. (request. id value can be any value from 
0 to 255. 
• Invalid request. id has value -1). 


Async Response Message: 


Pre Conditions: 


е TelOemSsSetCallBarringReq should be called in prior.. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
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* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.147 TelOemSsChangeBarPasswordCnf 


Functions 


* BOOL TelOemSsChangeBarPasswordCnf (TelSsCause t Cause) 


This function sends the confirmation for the change of call barring password from lower layers. 


5.147.1 Function Documentation 
5.147.1.1 BOOL TelOemSsChangeBarPasswordCnf (TelSsCause t Cause) 
This function sends the confirmation for the change of call barring password from lower layers. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 
Async Response Message: 


TelOemSsChangeBarPasswordReq should be called in prior. 


Pre Conditions: 


* TelOemSsChangeBarPasswordReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.148 TelOemSsGetCallBarringStatusCnf 


Functions 


* BOOL TelOemSsGetCallBarringStatusCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int 
RequestId) 


This function returns the confirmation of the call barring status from the lower layers. 


5.148.1 Function Documentation 


5.148.1.1 BOOL TelOemSsGetCallBarringStatusCnf (TelSsCause t Cause, const TelSsInfo (ж 
pSsInfo, int RequestId) 


This function returns the confirmation of the call barring status from the lower layers. 
Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 
< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


— Requestld Unique identifier for a particular request. (request id value can be any value from 0 to 
255. Invalid request. id has value -1) 


Async Response Message: 


Pre Conditions: 


* TelOemSsGetCallBarringStatusReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 
* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.149 TelOemSsSetCallForwardCnf 


Functions 


e BOOL TelOemSsSetCallForwardCnf (TelSsCause_t Cause, const TelSsInfo t *pSsInfo, int Request- 
Id) 


This function passes Register/Activate/Deactivate/Erase Call Forward confirmation to upper layers. 


5.149.1 Function Documentation 


5.149.1111 BOOL TelOemSsSetCallForwardCnf (TelSsCause t Cause, const TelSsInfo (ж pSsInfo, 
int Requestld) 


This function passes Register/Activate/Deactivate/Erase Call Forward confirmation to upper layers. 


Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


None. 
Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 


< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


— Requestld Unique identifier for a particular request. (request id value can be any value from 0 to 
255. Invalid request. id has value -1) 
Async Response Message: 


TelOemSsSetCallForwardReq should be called in prior. 


Pre Conditions: 


• TelOemSsSetCallForwardReq should be called in prior. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 
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Prospective Clients: 


OEM Adaptation Layer. 
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5.150 TelOemSsGetCallForwardStatusCnf 


Functions 


e BOOL TelOemSsGetCallForwardStatusCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int 
RequestId) 


This function is the confirmation for TelOemSsGetCallForwardStatusReq call from the lower layers to the 
Telephony Server. 


5.150.1 Function Documentation 


5.150.1.1 BOOL TelOemSsGetCallForwardStatusCnf (TelSsCause t Cause, const TelSsInfo t х 
pSsInfo, int RequestId) 


This function is the confirmation for TelOemSsGetCallForwardStatusReq call from the lower layers to the 
Telephony Server. 
Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


Warning: 


* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 


< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


< RequestId Unique identifier for a particular request. (request id value can be any value from 0 to 
255. Invalid request. id has value -1) 


Async Response Message: 


Pre Conditions: 


* TelOemSsGetCallForwardStatusReq should be called in prior.. 


Post Conditions: 


* None. 


Returns: 


Return Type (BOOL) 
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* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.151 TelOemSsSetCallWaitingCnf 


Functions 


• BOOL TelOemSsSetCallWaitingCnf (TelSsCause t Cause, const TelSsInfo t *pSsInfo, int Request- 
Id) 
This function passes the confirmation for the TelOemSsSetCallWaitingReq call from the lower layers. 


5.151.1 Function Documentation 


5.151.1.1 BOOL TelOemSsSetCallWaitingCnf (TelSsCause t Cause, const TelSsInfo t х pSsInfo, 
int Requestld) 


This function passes the confirmation for the TelOemSsSetCallWaitingReq call from the lower layers. 
Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 
< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


< Requestld Unique identifier for a particular request. (request id value can be any value from 0 to 
255. Invalid request. id has value -1) 


Async Response Message: 


Pre Conditions: 


* TelOemSsSetCallWaitingReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 
* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.152 TelOemSsGetCallWaitingStatusCnf 


Functions 


e BOOL TelOemSsGetCallWaitingStatusCnf (TelSsCause_t Cause, const TelSsInfo t *pSsInfo, int 
RequestId) 


This function passes the call waiting status result from the lower layers to Telephony Server. 


5.152.1 Function Documentation 


5.15211 BOOL TelOemSsGetCallWaitingStatusCnf (TelSsCause_t Cause, const TelSsInfo (ж 
pSsInfo, int RequestId) 


This function passes the call waiting status result from the lower layers to Telephony Server. 
Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 
< pSsInfo • Supplementary service information like ss status, ss type, teleservice etc. 
* [f cause is other than SUCCESS, then pSsInfo shall be NULL. 


< Requestld Unique identifier for a particular request. (request id value can be any value from 0 to 
255. Invalid request. id has value -1) 


Async Response Message: 


Pre Conditions: 


* TelOemSsGetCallWaitingStatusReq should be called in prior. 


Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 
* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.153 TelOemSsSendUssdCnf 


Functions 


e BOOL TelOemSsSendUssdCnf (const TelSsUssdMsgInfo t *pUssdMsgInfo, TelSsCause_- 
t Cause) 
This function will be called to provide the final USSD confirmation once USSD Transaction is complete. 


5.153.1 Function Documentation 


5.153.1.4 BOOL TelOemSsSendUssdCnf (const TelSsUssdMsglInfo t x pUssdMsgInfo, 
TelSsCause t Cause) 


This function will be called to provide the final USSD confirmation once USSD Transaction is complete. 


Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< pUssdMsgInfo — * Structure holds USSD Data information like whether any user acknowledge- 
ments, what encoding used for USSD Data , USSD Data length and USSD data etc. 
• If cause is other than SUCCESS, then pUSSDMsgInfo shall be Null. 


< Cause • Describes whether a supplementary service request was a success or a failure and if it 
failed, why. 


Async Response Message: 


Pre Conditions: 
-None. 
Post Conditions: 
* None. 
Returns: 


Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.154 TelOemSsUssdInd 


Functions 


e BOOL TelOemSsUssdInd (const TelSsUssdMsgInfo_t *pUssdMsglInfo) 


This function sends the unsolicited indication of the USSD String received from the network to the upper lay- 
ers. This function is called to indicate unsolicited indication which can be an intermediate USSD message 
during a USSD session or it can new USSD session initiated by the network to UE. 


5.154.1 Function Documentation 
5.154.1.1 BOOL TelOemSsUssdInd (const TelSsUssdMsglInfo (ж pUssdMsgInfo) 


This function sends the unsolicited indication of the USSD String received from the network to the up- 
per layers. This function is called to indicate unsolicited indication which can be an intermediate USSD 
message during a USSD session or it can new USSD session initiated by the network to UE. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< pUssdMsgInfo • Structure holds USSD Data information like whether any user acknowledge- 
ments, what encoding used for USSD Data , USSD Data length and USSD data . 


Async Response Message: 


Pre Conditions: 


* None. 
Post Conditions: 

* None. 
Returns: 


Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.155 TelOemSsQueryCapabilityInfoCnf 


Functions 


• BOOL TelOemSsQueryCapabilityInfoCnf (TelSsCause t Cause, const TelSsCapabilityInfo_t жр55- 
CapInfo) 


This function sends the confirmation for the supported SS services query at the lower layers. 


5.155.1 Function Documentation 


5.155.1.1 BOOL TelOemSsQueryCapabilityInfoCnf (TelSsCause_t Cause, const 
TelSsCapabilityInfo t « pSsCapInfo) 


This function sends the confirmation for the supported SS services query at the lower layers. 
Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< Cause • Describes whether a supplementary service request was a success or a failure. The pos- 
sible Tapi Cause values are TAPI 55 OPERATION SUCCESS/ TAPI 55 OEM NOT - 
SUPPORTED/ 
* TAPI SS REJ UNRECOGNIZED ERROR 
< pSsCapInfo • SS services supported. 
* If cause is other than SUCCESS, then pSsCapInfo shall be NULL. 


Async Response Message: 


Pre Conditions: 
-TelOemSsQueryCapabilityInfoReq should be called in prior. 
Post Conditions: 
* None. 


Returns: 


Return Type (BOOL) 
* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.156 TelOemSsGetPwdInd 


Functions 


• BOOL TelOemSsGetPwdlInd (TelSsCallBarType t PwdType) 


This function sends the Indication of the get password request to the upper layers which is received from 
network. 


5.156.1 Function Documentation 
5.156.1.1 BOOL TelOemSsGetPwdInd (TelSsCallBarType t PwdType) 


This function sends the Indication of the get password request to the upper layers which is received from 
network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


Warning: 
* None. 


Parameters: 


< PwdType | * OEM will provide Pwd type is passed based on the changed barring password or 
SetCallbarring request service triggered. This will based on network request.. 


Async Response Message: 


Pre Conditions: 


* TelOemSsChangeBarPasswordReq or TelOemSsSetCallBarringReq API should be called. 


Post Conditions: 


* None. 


Returns: 
Return Type (BOOL) 


* TRUE - indicating that the operation has completed successfully. 
* [n case of failure, FALSE will be returned. 


Prospective Clients: 


OEM Adaptation Layer. 
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5.157 Call Data Structures 


Files 


file TelCall.h 


This file serves as a "C" header file defines structures for Tapi Call Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelCallCugInfo t 

struct TelCallingNamelInfo t 
struct TelCallUusInfo t 

struct TelCallSetupParams t 
struct TelCallStatus t 

struct TelCallUserDataInfo t 
struct TelCallEndInfo t 

struct TelCallRedirectionInfo t 
struct TelCallIncomingCallInfo t 


Defines 


#define ТАРІ CALLING NAME SIZE MAX 80 
#define ТАРІ CALL UUS DATA LEN MAX 131 


Enumerations 


enum TelCallCause t ( 


TAPI CAUSE SUCCESS, TAPI CAUSE ACCESSDISCARD, 
BYOPERATOR, TAPI CAUSE BEARERMODE NOTIMPL, 


TAPI CAUSE BARR - 


TAPI CAUSE BEARERMODE RESTRICTED, TAPI CAUSE BEARERMODE UNAUTH, 


TAPI CAUSE BEARERMODE UNAVAIL, TAPI CAUSE BUSY, 


TAPI CAUSE CALLMETER EXPIRED, TAPI CAUSE CALLNO ERROR, TAPI CAUSE - 


CKTUNAVAIL, TAPI CAUSE CONGESTION, 


TAPI CAUSE NO CIRCUIT AVAIL, TAPI CAUSE DESTIN INCOMPAT, TAPI CAUSE - 


DTMF NOSPEECH, TAPI CAUSE DTMF REJECTED, 


TAPI CAUSE FACILITY NOTIMPL, TAPI CAUSE FACILITY NOTSUBSCRIBED, TAPI - 
CAUSE INCOMINGCUGCALLS BARRED, TAPI CAUSE INVALNUM, 


TAPI CAUSE MPTY ERROR, TAPI CAUSE NOANSWER, TAPI CAUSE - 
NONCUGMEMBER, TAPI CAUSE NUMBERCHANGED, 
TAPI CAUSE NUMBER ERROR, TAPI CAUSE NWFAILURE, TAPI CAUSE - 


OPERATIONUNAVAIL, TAPI CAUSE OUTOFORDER, 


TAPI CAUSE PROTOCOL ERROR, TAPI CAUSE QOSUNAVAIL, TAPI CAUSE REJECT, 


TAPI CAUSE REJ FAIL, 


ТАРІ CAUSE КЕЈ SRVC NOT АУ, ТАРІ CAUSE REMOTE CKTUNAVAIL, ТАРІ - 


CAUSE RESOURCEUNAVAIL, TAPI CAUSE SERVICEID ERROR, 
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ТАРІ CAUSE SERVICE NOTIMPL, ТАРІ CAUSE SERVICE UNAVAIL, ТАРІ CAUSE - 
MODIFY SAME BEARER, TAPI CAUSE MODIFY NOT PERMITTED, 


TAPI CAUSE HOLD FAIL, TAPI CAUSE TEMPFAILURE, TAPI CAUSE WRONGNUM, 
TAPI CAUSE NORMAL UNSPECIFIED, 


TAPI CAUSE SSERRINVALIDTIVALUE, TAPI CAUSE SSERRINVALIDTI, TAPI CAUSE - 
SSINCOMPATIBLESTATE, TAPI CAUSE SSERRSYNTAXERROR, 


TAPI CAUSE SSPROTOCOLERROR, ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK, 
ТАРІ CAUSE SSSENTASPHASEI, ТАРІ CAUSE SSERROR, 

TAPI CAUSE SS USSD BUSY, TAPI CAUSE IDLE, TAPI CAUSE NETWORK SPECIFIC, 
TAPI CAUSE FADE, 

TAPI CAUSE UNKNOWN, ТАРІ CAUSE INCOM CALL, ТАРІ CAUSE ALERT STOP, 
TAPI CAUSE INTERCEPT, 

TAPI CAUSE REORDER, TAPI CAUSE CLIENT END, TAPI CAUSE ACCESS CLASS - 
BLOCKED, TAPI CAUSE MEMCAPEXCEEDED, 

ТАРІ CAUSE TYPENOTSUPPORTED, ТАРІ CAUSE REPLACENOTSUPPORTED, ТАРІ - 
CAUSE PROTOCOLID ERROR, TAPI CAUSE CLASSNOTSUPPORTED, 


TAPI CAUSE DATACODING ERROR, TAPI CAUSE INVAL MSG, TAPI CAUSE CALL - 
BARRED, TAPI CAUSE SIM CALL CONTROL CHANGED TO SS, 


TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL, TAPI CAUSE SIM ERROR, 
TAPI CAUSE SIM CALL CONTROL MODIFIED, TAPI CAUSE RANDOM ACCESS - 
FAILURE, 
TAPI CAUSE LOWER LAYER FAILURE, ТАРІ CAUSE ACCESS REJECTED, ТАРІ - 
CAUSE REEST NOT ALLOWED, TAPI CAUSE EMERGENCY CALL NOT ALLOWED, 


TAPI CAUSE ACCESS NOT ALLOWED, TAPI CAUSE RADIO LINK FAILURE, TAPI - 
CAUSE INVALID IDENTITY, TAPI CAUSE UNKNOWN IDENTITY, 

TAPI CAUSE UNACCEPTABLE IDENTITY, TAPI CAUSE NO SERVICE HERE, TAPI - 
CAUSE SERVICE NOT ALLOWED, TAPI CAUSE SERVICE NOT AVAIL, 

TAPI CAUSE SERVICE NOT WORKING, TAPI CAUSE CANNOT IDENTIFY CALL, 
TAPI CAUSE DEACTIVATION, TAPI CAUSE FATAL ERROR } 

enum TelCallAnswerType t { ТАРІ CALL ANSWER ACCEPT = 0, ТАРІ CALL ANSWER - 
REJECT = 1 } 

enum TelCallType t ( TAPI CALL TYPE VOICE, TAPI CALL TYPE DATA, TAPI CALL - 
TYPE E911 } 

enum TelCallAlertingPattern t { 


ТАРІ CALL ALERTING PATTERN 1 = 0x00, ТАРІ CALL АГЕКТІМС PATTERN 2 = 0x01, 
ТАРІ САШ, ALERTING PATTERN 3 = 0x02, ТАРІ CALL ALERTING PATTERN 4 = 0x03, 


ТАРІ CALL ALERTING PATTERN 5 = 0x04, ТАРІ CALL АГЕКТІМС PATTERN 6 = 0x05, 
ТАРІ CALL ALERTING PATTERN 7 = 0x06, ТАРІ CALL ALERTING PATTERN 8 = 0x07, 
TAPI CALL NO ALERTING PATTERN = 0x08 } 

enum  TelCallActivestate t { ТАРІ CALL CONNECT IDLE, ТАРІ CALL CONNECT - 
ACTIVE, TAPI CALL CONNECT HELD ] 

enum TelCallIdentityMode t ( TAPI CALL IDENTITY DEFAULT, TAPI CALL IDENTITY - 
SHOW, TAPI CALL IDENTITY HIDE } 

enum TelCallCugOptions t { TAPI CALL CUG NO INFO = 0x00, TAPI CALL CUG - 
SUPRESS OA, ТАРІ CALL СОС SUPRESS РКЕ СОС, ТАРІ CALL СОС SUPRESS OA - 
AND ССС) 

enum TelCallUusType t ( TAPI CALL UUS NONE, TAPI CALL UUS 1) 
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* enum TelCallUusProtocolType t { 


TAPI CALL UUS PROTO SPECIFIC - 0, TAPI CALL UUS PROTO OSI HIGHER LAYER 
= 1, ТАРІ CALL UUS PROTO IA5 CHARS = 4, ТАРІ CALL UUS PROTO V120 - 7, 


TAPI CALL UUS PROTO 0931-8) 


enum TelCallNameMode_t { ТАРІ CALL NAME AVAIL = 0, ТАРІ CALL NAME - 
RESTRICTED = 1, TAPI CALL NAME UNAVAIL = 2, TAPI CALL NAME AVAIL - 
RESTRICTED = 3 } 


5.157.1 Define Documentation 


5.157.1.1 ffdefine ТАРІ CALL UUS DATA LEN MAX 131 


The Maximum length of the user to user signaling data string. 


5.157.1.2 #define ТАРІ CALLING NAME SIZE MAX 80 


The maximum length of the string for calling party name. 


5.157.2 Enumeration Type Documentation 
5.157.2.1 enum TelCallActiveState_t 


State of the current call. 


Enumerator: 
TAPI_CALL_CONNECT_IDLE Call is in Idle state. 
TAPI CALL CONNECT ACTIVE Call is in Active state. 
TAPI CALL CONNECT HELD Call is in Held state. 


5.157.2. enum TelCallAlertingPattern t 
This enumeration defines the different alerting patterns available. 


Enumerator: 
TAPI CALL ALERTING PATTERN 1 Pattern 1 
TAPI CALL ALERTING PATTERN 2 Pattern 2 
TAPI CALL ALERTING PATTERN 3 Pattern 3 
TAPI CALL ALERTING PATTERN 4 Pattern 4 
TAPI CALL ALERTING PATTERN 5 Pattern 5 
TAPI CALL ALERTING PATTERN 6 Pattern 6 
TAPI CALL ALERTING PATTERN 7 Pattern 7 
TAPI CALL ALERTING PATTERN 8 Pattern 8 
TAPI CALL NO ALERTING PATTERN No Alerting Pattern 
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5.157.2.3 enum TelCallAnswerType t 
Answer type used as in parameter in the answer call API. 


Enumerator: 


TAPI CALL ANSWER ACCEPT Used to answer an incoming call when there are no current ac- 
tive calls. 


TAPI CALL ANSWER REJECT Used to reject the incoming call 


5.157.2.4 enum TelCallCause t 


This structure defines the values for Call Cause. 


Enumerator: 


TAPI CAUSE SUCCESS Success 

TAPI CAUSE ACCESSDISCARD Access discarded 

TAPI CAUSE BARR BYOPERATOR Barred by operator 

TAPI CAUSE BEARERMODE NOTIMPL Bearer mode not implemented 
TAPI CAUSE BEARERMODE RESTRICTED  Bearer mode restricted 
TAPI CAUSE BEARERMODE UNAUTH  Bearer mode un authorized 
ТАРІ CAUSE BEARERMODE UNAVAIL Bearer mode not available 
ТАРІ CAUSE BUSY (Network/Server) busy 

TAPI CAUSE CALLMETER EXPIRED Call meter expired 

TAPI CAUSE CALLNO ERROR Call number error 

TAPI CAUSE CKTUNAVAIL Circuit channel unavailable 

TAPI CAUSE CONGESTION Congestion happened 

TAPI CAUSE NO CIRCUIT AVAIL Circuit not available 

TAPI CAUSE DESTIN INCOMPAT Destination incompatibility 

TAPI CAUSE DTMF NOSPEECH Хо speech in DTMF 

TAPI CAUSE DTMF REJECTED DTMF rejected 

TAPI CAUSE FACILITY NOTIMPL Facility not implemented 

TAPI CAUSE FACILITY NOTSUBSCRIBED Facility not subscribed 
TAPI CAUSE INCOMINGCUGCALLS BARRED Incoming CUG Calls barred 
TAPI CAUSE INVALNUM Invalid number 

TAPI CAUSE MPTY ERROR Multiparty error 

ТАРІ CAUSE NOANSWER Мо answer 

TAPI CAUSE NONCUGMEMBER Non CUG member 

TAPI CAUSE NUMBERCHANGED Number changed 

TAPI CAUSE NUMBER ERROR Number error 

TAPI CAUSE NWFAILURE Network failure 

TAPI CAUSE OPERATIONUNAVAIL Operation not available 

TAPI CAUSE OUTOFORDER Out of order 

TAPI CAUSE PROTOCOL ERROR Protocol error 
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TAPI CAUSE QOSUNAVAIL QOS unavailable 

TAPI CAUSE REJECT Rejected 

TAPI CAUSE REJ FAIL Rejection failed 

ТАРІ CAUSE КЕЈ SRVC NOT AVL Rejection service not available 
TAPI CAUSE REMOTE CKTUNAVAIL Remote Circuit channel unavailable 
TAPI CAUSE RESOURCEUNAVAIL Resource not available 

TAPI CAUSE SERVICEID ERROR Service id error 

TAPI CAUSE SERVICE NOTIMPL Service not implemented 

TAPI CAUSE SERVICE UNAVAIL Service not available 

TAPI CAUSE MODIFY SAME BEARER Modify same bearer 

TAPI CAUSE MODIFY NOT PERMITTED Modification not permitted 
TAPI CAUSE HOLD FAIL Call hold fail 

TAPI CAUSE TEMPFAILURE Temporary failure 

TAPI CAUSE WRONGNUM Wrong number 

TAPI CAUSE NORMAL UNSPECIFIED Normal but unspecified 

TAPI CAUSE SSERRINVALIDTIVALUE SS invalid Transaction ID Value 
TAPI CAUSE SSERRINVALIDTI SS Invalid transaction ID 

TAPI CAUSE SSINCOMPATIBLESTATE SS incompatible state 

TAPI CAUSE SSERRSYNTAXERROR SS syntax error 

TAPI CAUSE SSPROTOCOLERROR Protocol error 

ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK Negative password check 
ТАРІ CAUSE SSSENTASPHASEI SS sent as phasel message 

TAPI CAUSE SSERROR Supplementary service error 


TAPI CAUSE SS USSD BUSY Second USSD request will be rejected when already USSD trans- 
action is ongoing. 


TAPI CAUSE IDLE Idle 

TAPI CAUSE NETWORK SPECIFIC Network specific error 
TAPI CAUSE FADE voice call was dropped e.g. because of a loss of signal 
TAPI CAUSE UNKNOWN unknown no details available 

TAPI CAUSE INCOM CALL terminated by incoming call 

TAPI CAUSE ALERT STOP terminated by alert stop 

TAPI CAUSE INTERCEPT voice call was dropped by interception 
TAPI CAUSE REORDER voice call was dropped by reordering 
TAPI CAUSE CLIENT END client ended the call 

TAPI CAUSE ACCESS CLASS BLOCKED access class blocked 
TAPI CAUSE MEMCAPEXCEEDED Memory capacity exceeded 
TAPI CAUSE TYPENOTSUPPORTED Type not supported 

TAPI CAUSE REPLACENOTSUPPORTED Replace not supported 
TAPI CAUSE PROTOCOLID ERROR Protocol id error 

TAPI CAUSE CLASSNOTSUPPORTED Class not supported 

TAPI CAUSE DATACODING ERROR Data coding error 
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TAPI CAUSE INVAL MSG Invalid message 

TAPI CAUSE CALL BARRED Call barred 

ТАРІ CAUSE SIM CALL CONTROL CHANGED TO SS Sim call control changed to SS 
TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL SIM Call control changed to call 


TAPI CAUSE SIM ERROR SIM error 

TAPI CAUSE SIM CALL CONTROL MODIFIED SIM call control modified 
TAPI CAUSE RANDOM ACCESS FAILURE Random access error 

TAPI CAUSE LOWER LAYER FAILURE Lower layer error 

TAPI CAUSE ACCESS REJECTED Access rejected 

TAPI CAUSE REEST NOT ALLOWED Reset not allowed 

TAPI CAUSE EMERGENCY CALL NOT ALLOWED Emergency call not allowed 
TAPI CAUSE ACCESS NOT ALLOWED Access not allowed 

TAPI CAUSE RADIO LINK FAILURE Radio link failure 

TAPI CAUSE INVALID IDENTITY Invalid identity 

TAPI CAUSE UNKNOWN IDENTITY Unknown identity 

TAPI CAUSE UNACCEPTABLE IDENTITY Un acceptable identity 

TAPI CAUSE NO SERVICE HERE No service here 

TAPI CAUSE SERVICE NOT ALLOWED Service not allowed 

TAPI CAUSE SERVICE NOT AVAIL Service not available 

TAPI CAUSE SERVICE NOT WORKING Service not working 

TAPI CAUSE CANNOT IDENTIFY CALL Cannot identify the call 

ТАРІ CAUSE DEACTIVATION Deactivation 

TAPI CAUSE FATAL ERROR Fatal error 


5.157.2.5 enum TelCallCugOptions t 


This enumeration defines the closed user group options 


Enumerator: 


TAPI CALL CUG NO INFO No information 

TAPI CALL CUG SUPRESS OA suppress OA 

TAPI CALL CUG SUPRESS PRF CUG suppress preferential CUG 

TAPI CALL CUG SUPRESS OA AND CUG suppress OA and preferential CUG 


5.157.2.6 enum TelCallIdentityMode t 


This enumeration defines the identity mode option for a call 


Enumerator: 
TAPI CALL IDENTITY DEFAULT Calling line identity will be sent. Based on network setting, 
Line identity will presented to the called party. 
TAPI CALL IDENTITY SHOW Display calling line identity 
TAPI CALL IDENTITY HIDE Hide the display of Calling line identity 
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5.157.27 enum TelCallNameMode t 


This enumeration defines the call name mode 


Enumerator: 


TAPI CALL NAME AVAIL This identifier refers to the presentation of the calling party's name 
identity to the called party. 


TAPI CALL NAME RESTRICTED This identifier refers to the restriction of presentation of the 
name identity of the calling party to the called party. 

TAPI CALL NAME UNAVAIL This identifier refers to the unavailability of the calling party's 
name identity to be offered to the called party. 


TAPI CALL NAME AVAIL RESTRICTED This identifier refers to the calling party's name iden- 
tity to be offered to the called party with which presentation restriction is overridden. 


5.157.2.8 enum TelCallType t 


Applications needs to use this call type while using the setip call API. Like the requested call is a voice call 
or video call. 


Enumerator: 


TAPI CALL TYPE VOICE Voice call type. 
TAPI CALL TYPE DATA Data call type - (for modem, fax, packet, etc. calls). 
TAPI CALL TYPE E911 Emergency call type. 


5.157.2.9 enum TelCallUusProtocolType t 
This enumeration defines the tapi call uus protocol types 


Enumerator: 


TAPI CALL UUS PROTO SPECIFIC The user information is structured according to user needs. 


ТАРІ CALL UUS РКОТО OSI HIGHER LAYER OSI high layer protocols 

ТАРІ CALL UUS PROTO ІА5 CHARS user information consists of IA5 characters 
TAPI CALL UUS PROTO VI20 rate adaptation 

ТАРІ CALL UUS РКОТО 0931 user-network call control messages 


5.157.2.10 enum TelCallUusType t 
This enumeration defines the UUS Type 


Enumerator: 


TAPI CALL UUS NONE No User to User information 
ТАРІ CALL UUS 1 User to User information 1 
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Files 


file TelNetText.h 


This file serves as а "С" header file defines structures for Tapi Network Text Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSmsCbConfig_t 

struct TelSmsAddressInfo_t 

struct TelSmsParams_t 

struct TelSmsDatapackageInfo_t 
struct TelSmsData_t 

struct TelSmsStoredMsgCountInfo_t 
struct TelSmsCbMsg t 


Defines 


#define TAPI NETTEXT CB PAGE SIZE MAX 93 

fdefine TAPI NETTEXT GSM SMS MSG NUM MAX 90 

fdefine TAPI NETTEXT GSM SMS CBMI LIST SIZE MAX 60 

#define TAPI NETTEXT SMDATA SIZE MAX 160 

#define TAPI NETTEXT MAX GSM SMS SERVICE CENTER ADDR 12 
#define TAPI NETTEXT MAX INDEX 255 

#define TAPI SIM SMSP ADDRESS LEN 20 

fdefine TAPI SIM SMSP ALPHA ID LEN MAX 32 


Enumerations 


enum TelSmsMsgStatus_t { 


TAPI NETTEXT STATUS READ, TAPI NETTEXT STATUS UNREAD, TAPI NETTEXT - 


STATUS SENT, TAPI NETTEXT STATUS UNSENT, 


TAPI NETTEXT STATUS DELIVERED, TAPI NETTEXT STATUS DELIVERY - 
UNCONFIRMED, TAPI NETTEXT STATUS MESSAGE REPLACED, ТАРІ NETTEXT - 


STATUS RESERVED } 
enum TelSmsBearerType t ( 


TAPI NETTEXT BEARER PS ONLY = 0x01, TAPI NETTEXT BEARER CS ONLY, TAPI - 


NETTEXT BEARER PS PREFERRED, TAPI NETTEXT BEARER CS PREFERRED, 


TAPI NETTEXT NO PREFERRED BEARER } 


enum TelSmsCbMsgType t { ТАРІ NETTEXT CB MSG CBS = 1], ТАРІ NETTEXT - 
СВ MSG SCHEDULE, ТАРІ NETTEXT CB MSG СВ541, ТАРІ NETTEXT CB MSG - 


INVALID } 
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* enum TelSmsResponse t { 


ТАРІ NETTEXT SENDSMS SUCCESS = 0x00, TAPI NETTEXT ROUTING NOT - 
AVAILABLE, TAPI NETTEXT INVALID PARAMETER, TAPI NETTEXT DEVICE - 
FAILURE, 


ТАРІ NETTEXT SERVICE RESERVED, ТАРІ NETTEXT INVALID LOCATION, ТАРІ - 
NETTEXT NO SIM, TAPI NETTEXT SIM NOT READY, 


TAPI NETTEXT NO NETWORK RESP, TAPI NETTEXT DEST ADDRESS FDN - 
RESTRICTED, ТАРІ NETTEXT SCADDRESS FDN RESTRICTED, ТАРІ NETTEXT - 
RESEND ALREADY DONE, 


TAPI NETTEXT SCADDRESS NOT AVAILABLE, TAPI NETTEXT UNASSIGNED - 
NUMBER, ТАРІ NETTEXT OPERATOR DETERMINED BARRING, ТАРІ NETTEXT - 
CALL BARRED, 


TAPI NETTEXT MESSAGE TRANSFER REJECTED, TAPI NETTEXT MEMORY - 
CAPACITY EXCEEDED, ТАРІ NETTEXT DESTINAITION OUTOFSERVICE, ТАРІ - 
NETTEXT UNSPECIFIED SUBSCRIBER, 


TAPI NETTEXT FACILITY REJECTED, TAPI NETTEXT UNKNOWN SUBSCRIBER, 
TAPI NETTEXT NETWORK. OUTOFORDER, TAPI NETTEXT TEMPORARY FAILURE, 


TAPI NETTEXT CONGESTION, TAPI NETTEXT RESOURCES UNAVAILABLE, 
TAPI NETTEXT FACILITY NOT SUBSCRIBED, TAPI NETTEXT FACILITY NOT - 
IMPLEMENTED, 


TAPI NETTEXT INVALID REF VALUE, TAPI NETTEXT INVALID MSG, TAPI - 
NETTEXT INVALID MANDATORY INFO, TAPI NETTEXT MESSAGE TYPE NOT - 


IMPLEMENTED, 

TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL, TAPI NETTEXT IE - 
NOT IMPLEMENTED, TAPI NETTEXT PROTOCOL ERROR, TAPI NETTEXT - 
INTERWORKING } 


enum TelSmsCause_t { 


ТАРІ NETTEXT SUCCESS, ТАРІ NETTEXT INVALID PARAMETER FORMAT, ТАРІ - 
NETTEXT PHONE FAILURE, ТАРІ NETTEXT SIM. BUSY, 


TAPI NETTEXT SIM FAILURE, TAPI NETTEXT UNKNOWN, TAPI NETTEXT - 
MEMORY FAILURE, TAPI NETTEXT OPERATION NOT SUPPORTED } 


5.1581 Define Documentation 


5.158.1.1 #ебпе ТАРІ NETTEXT CB PAGE SIZE МАХ 93 


CB maximum page size 


5.158.1.2 #ебпе ТАРІ NETTEXT GSM SMS CBMI LIST SIZE MAX 60 


Maximum GSM SMS CBMI list size 


5.158.1.3 #define ТАРІ NETTEXT GSM SMS MSG NUM МАХ 90 


Maximum GSM SMS message number 
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5.158.1.4 #ебпе ТАРІ NETTEXT SMDATA SIZE МАХ 160 


Maximum SMS data size that can be stored 


5.158.1.5 #ебпе ТАРІ SIM SMSP ADDRESS LEN 20 


digit length 


5.158.1.6 #ебпе ТАРІ SIM SMSP ALPHA ID LEN MAX 32 


alpha id length 


5.158.2 Enumeration Type Documentation 
5.158.2.1 enum TelSmsBearerType_t 
This enum defines the different bearer types 


Enumerator: 
TAPI_NETTEXT_BEARER_PS_ONLY Send SMS only on PS Bearer 
TAPI NETTEXT BEARER CS ONLY Send SMS only on CS Bearer 
TAPI NETTEXT BEARER PS PREFERRED Send SMS preferably on PS Bearer 
TAPI NETTEXT BEARER CS PREFERRED Send SMS preferably on CS Bearer 


TAPI NETTEXT NO PREFERRED BEARER SMS is sent based on default preferred bearer set 
at OEM based on vendor/operator preference 


5.158.2.2 enum TelSmsCause t 


This enum defines the differnet cause types that come in the sent status acknowledgement/notification after 
sending a message to the network 


Enumerator: 
TAPI NETTEXT SUCCESS Sms Operation successful 


TAPI NETTEXT INVALID PARAMETER FORMAT Invalid format for some parameters 
passed in Datapackage information(TPDU) 


ТАРІ NETTEXT PHONE FAILURE SMS operation failed due to Modem failure 


TAPI NETTEXT SIM BUSY SMS SIM operation cannot be performed as SIM is busy with some 
other operation 


ТАРІ NETTEXT SIM FAILURE SMS SIM operation cannot be performed due to sim failure 
TAPI NETTEXT UNKNOWN unknown error 


TAPI NETTEXT MEMORY FAILURE Error while accessing memory or allocation of memory 
for SMS operation. 


TAPI NETTEXT OPERATION NOT SUPPORTED operation not allowed/supported 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


198 Module Documentation 


5.158.2.3 enum Tel$msCbMsgType t 
This enumeration defines the different CB message types. 


Enumerator: 


TAPI NETTEXT CB MSG CBS Cell broadcast message 

TAPI NETTEXT CB MSG SCHEDULE CB Schedule message 
TAPI NETTEXT CB MSG CBS41 CBS41 type message 

TAPI NETTEXT CB MSG INVALID Invalid CB message 


5.158.2.4 enum TelSmsMsgStatus_t 
This enumeration defines the network text status type. 


Enumerator: 


TAPI NETTEXT STATUS READ MT message, stored and read 

TAPI NETTEXT STATUS UNREAD MT message, stored and unread 
TAPI NETTEXT STATUS SENT MO message, stored and sent 

TAPI NETTEXT STATUS UNSENT MO message, stored but not sent 
TAPI NETTEXT STATUS DELIVERED delivered destination 


TAPI NETTEXT STATUS DELIVERY UNCONFIRMED Service centre forwarded message 
but is unable to confirm delivery 


TAPI NETTEXT STATUS MESSAGE REPLACED Message has been replaced 
TAPI NETTEXT STATUS RESERVED Reserved for future use 


5.158.2.5 enum TelSmsResponse t 


This enum defines the different response types that come in the sent status acknowledgement/notification 
after sending a message to the network 


Enumerator: 


TAPI NETTEXT SENDSMS SUCCESS Message send success 

TAPI NETTEXT ROUTING NOT AVAILABLE Message routing not available 

TAPI NETTEXT INVALID PARAMETER Invalid parameter present in TPDU 

TAPI NETTEXT DEVICE FAILURE Device failure 

TAPI NETTEXT SERVICE RESERVED Reserved Service 

TAPI NETTEXT INVALID LOCATION Invalid location 

TAPI NETTEXT NO SIM No sim error 

TAPI NETTEXT SIM NOT READY Sim not ready error 

TAPI NETTEXT NO NETWORK RESP No response from network 

TAPI NETTEXT DEST ADDRESS FDN RESTRICTED Destination address restricted 
TAPI NETTEXT SCADDRESS FDN RESTRICTED Service center address restricted 
TAPI NETTEXT RESEND ALREADY DONE  Resend operation already done 
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TAPI NETTEXT SCADDRESS NOT AVAILABLE SCA address not available 

TAPI NETTEXT UNASSIGNED NUMBER Unassigned number 

TAPI NETTEXT OPERATOR DETERMINED BARRING Operator determined barring 

TAPI NETTEXT CALL BARRED Call barred 

TAPI NETTEXT MESSAGE TRANSFER REJECTED Message transfer rejected 

TAPI NETTEXT MEMORY CAPACITY EXCEEDED Memory capacity exceeded/memory full 


ТАРІ NETTEXT DESTINAITION OUTOFSERVICE Destination number/address out of ser- 


vice 
TAPI NETTEXT UNSPECIFIED SUBSCRIBER  Unspecified subscriber 
TAPI NETTEXT FACILITY REJECTED Facility rejected 
TAPI NETTEXT UNKNOWN SUBSCRIBER Unknown subscriber 
TAPI NETTEXT NETWORK OUTOFORDER Network out of order 
TAPI NETTEXT TEMPORARY FAILURE Temporary failure 
TAPI NETTEXT CONGESTION Congestion happened 
TAPI NETTEXT RESOURCES UNAVAILABLE Resource unavailable 
TAPI NETTEXT FACILITY NOT SUBSCRIBED Facility not subscribed by the user 
TAPI NETTEXT FACILITY NOT IMPLEMENTED Facility not implemented 
TAPI NETTEXT INVALID REF VALUE Invalid reference value 
TAPI NETTEXT INVALID MSG Invalid message 
TAPI NETTEXT INVALID MANDATORY INFO Invalid mandatory information 
TAPI NETTEXT MESSAGE TYPE NOT IMPLEMENTED Message type not implemented 
TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL Message not compact protocol 
TAPI NETTEXT IE NOT IMPLEMENTED Information element not implemented 
TAPI NETTEXT PROTOCOL ERROR Protocol error 
TAPI NETTEXT INTERWORKING Networking error 
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5.159 Network Data Structures 


Files 


* file TelNetwork.h 


This file serves as a "C" header file defines structures for Tapi Network Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelNetworkTimeAndZone t 
struct TelNetworkSystemlId t 
struct TelNetworkConfigSettings t 
struct TelNetworkInfo t 

struct TelNetworkList t 

struct TelNetworkRadioInfo t 


Defines 


• #define ТАРІ NETWORK ORDER MAX 5 

* #define TAPI NETWORK LIST MAX 15 

• #define ТАРІ NETWORK NAME LEN MAX 40 
• #define ТАРІ NETWORK SPN LEN MAX 20 


Enumerations 


enum ‘TelNetworkSelectionMode_t { ТАРІ NETWORK. SELECTIONMODE AUTOMATIC, 
TAPI NETWORK SELECTIONMODE MANUAL } 


enum  TelNetworkSystemIdFormat t { ТАРІ NETWORK SYSID FORMAT 51р, ТАРІ - 
NETWORK, SYSID FORMAT PLMN } 


enum TelNetworkServiceDomain t { ТАРІ NETWORK, SERVICE DOMAIN COMBINED, 
ТАРІ NETWORK. SERVICE DOMAIN. PS, ТАРІ NETWORK. SERVICE DOMAIN. CS, 
TAPI NETWORK, SERVICE DOMAIN AUTOMATIC } 


enum TelNetworkMode t ( 

TAPI NETWORK MODE EMERGENCY, TAPI NETWORK. MODE AUTOMATIC, TAPI - 
NETWORK. MODE CDMA, TAPI NETWORK. MODE GSM, 

TAPI NETWORK, MODE WCDMA, TAPI NETWORK, MODE WLAN } 


enum  TelNetworkServiceLevel t { ТАРІ NETWORK SERVICE LEVEL МО, TAPI - 
NETWORK, SERVICE LEVEL EMERGENCY, ТАРІ NETWORK SERVICE LEVEL ЕСТІ, 
ТАРІ NETWORK, SERVICE LEVEL, SEARCH } 


enum TelNetworkServiceType t { 


TAPI NETWORK SERVICE TYPE NO SVE, TAPI NETWORK SERVICE TYPE - 
LIMITED, ТАРІ NETWORK. SERVICE TYPE CS, ТАРІ NETWORK SERVICE TYPE PS, 


TAPI NETWORK SERVICE TYPE COMBINED } 
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enum TelNetworkSystemType t { 


TAPI NETWORK SYSTEM NO SRV, TAPI NETWORK SYSTEM CDMA, TAPI - 
NETWORK SYSTEM TDMA, TAPI NETWORK. SYSTEM GSM, 


TAPI NETWORK SYSTEM GPRS, TAPI NETWORK SYSTEM EGPRS, TAPI - 
NETWORK SYSTEM РС51900, ТАРІ NETWORK SYSTEM UMTS, 


ТАРІ NETWORK SYSTEM GSM AND UMTS } 


enum TelNetworkBandPreferred t { ТАРІ NETWORK, BAND MODE PREFERRED = 0x01, 


TAPI NETWORK, BAND MODE ONLY = 0x02 } 
enum TelNetworkBand. t { 


TAPI NETWORK BAND TYPE ANY - 0x00, TAPI NETWORK BAND TYPE GSMS50, 


TAPI NETWORK BAND TYPE GSM 900 1800, 
GSM1900, 


TAPI NETWORK BAND TYPE - 


TAPI NETWORK BAND TYPE GSM, TAPI NETWORK BAND TYPE WCDMA, TAPI - 
NETWORK BAND TYPE WCDMAS50, ТАРІ NETWORK BAND TYPE WCDMAI900, 


ТАРІ NETWORK BAND TYPE WCDMA2100 } 
enum TelNetworkOperationCause t { 


ТАРІ NETWORK NO ERR = 0x00, ТАРІ NETWORK OPERATION FAILED, ТАРІ - 
NETWORK PHONE IN USE ERR, TAPI NETWORK OFFLINE ERR, 


TAPI NETWORK CONFIG SETTINGS FAILURE ERR, 
FAILURE ERR } 


TAPI NETWORK INTERNAL - 


enum TelNetworkDayLightSavingAdj t { ТАРІ NETWORK DLS ADJ NO ADJUSTMENT, 


TAPI NETWORK DLS ADJ PLUS ONE HOUR, TAPI NETWORK DLS PLUS TWO - 


HOUR } 


5.159.1 Define Documentation 
5.159.1.1 #define ТАРІ NETWORK LIST МАХ 15 


Maximum network list 


5.159.1.2 #define ТАРІ NETWORK NAME LEN MAX 40 


Maximum network name or PLMN name length 


5.159.1.3 #ебпе ТАРІ NETWORK ORDER МАХ 5 


Maximum network order 


5.159.1.4 #define ТАРІ NETWORK SPN LEN MAX 20 


Maximum network service provider name length 


5.159.2 Enumeration Type Documentation 
5.159.2.1 enum TelNetworkBand t 


This enumeration defines different network Bands. 
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Enumerator: 
TAPI NETWORK BAND TYPE ANY АП bands can be tried. 
ТАРІ NETWORK BAND TYPE 68М850 This member sets the band to GSM 850 
TAPI NETWORK BAND TYPE GSM 900 1800 This member sets the band to GSM 900 1800 
ТАРІ NETWORK BAND TYPE GSMI900 GSM 1900 
TAPI NETWORK BAND TYPE GSM This member sets all GSM bands 
TAPI NETWORK BAND TYPE WCDMA This member sets all WCDMA bands 
ТАРІ NETWORK BAND TYPE WCDMAGSSO0 This member sets the band to WCDMA 850 
ТАРІ NETWORK BAND TYPE WCDMAI900 This member sets the band to WCDMA 1900 
TAPI NETWORK BAND TYPE WCDMA2100 This member sets the band to WCDMA 2100 


5.159.2.2 enum TelNetworkBandPreferred t 
This enumeration defines the opeartions that can be done on network Band. 


Enumerator: 


TAPI NETWORK BAND MODE PREFERRED Preferred band. (If preferred Band is not avail- 
able, then underlying modem can search on other bands) 


TAPI NETWORK BAND MODE ONLY This allows only particular band. 


5.159.2.3 enum TelNetworkDayLightSavingAdj t 
This enumeration defines the day light saving adjustment time. 


Enumerator: 
TAPI NETWORK DLS ADJ NO ADJUSTMENT No adjustment specified on day light saving 
TAPI NETWORK DLS ADJ PLUS ONE HOUR Day light saving adjusted for one hour 
TAPI NETWORK DLS PLUS TWO HOUR Day light saving adjusted for two hours 


5.159.2.4 enum TelNetworkMode t 


This enumeration defines the network modes. 


Enumerator: 


TAPI NETWORK MODE EMERGENCY This member sets the emergency network mode 


TAPI NETWORK MODE AUTOMATIC This member sets the automatic network mode. Based 
on OEM priority, nw mode preference will be used 


TAPI NETWORK MODE CDMA This member sets the network mode to CDMA 
TAPI NETWORK MODE GSM This member sets the network mode to GSM 

TAPI NETWORK MODE WCDMA This member sets the network mode to WCDMA 
TAPI NETWORK MODE WLAN This member sets the network mode to WLAN 
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5.159.2.5 enum TelNetworkOperationCause t 
This enumeration defines different network operation cause. 


Enumerator: 
TAPI NETWORK NO ERR There is no error for any network operation. 
TAPI NETWORK OPERATION FAILED There is no error for any network operation. 


TAPI NETWORK PHONE IN USE ERR This error will be returned when any network opera- 
tion is tried while phone is in use(eg, Voice / Data call in progress due to which network operation 
failed) 


TAPI NETWORK OFFLINE ERR This error is sent when any network option is tried when 
phone is in offline mode 


TAPI NETWORK CONFIG SETTINGS FAILURE ERR This error is sent when modem is un- 
able to process the config settings information. 


TAPI NETWORK INTERNAL FAILURE ERR This error to indicate internal failure 


5.159.2.6 enum TelNetworkSelectionMode t 


This enumeration defines the network selection modes. 


Enumerator: 


TAPI NETWORK SELECTIONMODE AUTOMATIC Network selection is in Automatic selec- 
tion mode 


TAPI NETWORK SELECTIONMODE MANUAL Network selection is in Manual selection 
mode 


5.159.2.7 enum TelNetworkServiceDomain t 


This enumeration defines the network service domains . 


Enumerator: 


TAPI NETWORK SERVICE DOMAIN COMBINED This member sets the Circuit switch and 
Packet Switch domain 


TAPI NETWORK SERVICE DOMAIN PS This member sets the Packet Switch service domain 
TAPI NETWORK SERVICE DOMAIN CS This member sets the Circuit Switch service domain 


TAPI NETWORK SERVICE DOMAIN AUTOMATIC This member sets the service domain to 
Circuit Switch and Packet Switch or Circuit Switch or Packet Switch domain 


5.159.2.8 enum TelNetworkServiceLevel t 


This enumeration defines the status of network service. 


Enumerator: 


TAPI NETWORK SERVICE LEVEL NO No service available in the network ME is camped 
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TAPI NETWORK SERVICE LEVEL EMERGENCY Only emergency service available in the 
network ME is camped 


TAPI NETWORK SERVICE LEVEL FULL FULL service available in the network ME is 
camped 


TAPI NETWORK SERVICE LEVEL SEARCH Searching for service 


5.159.2.9 enum TelNetworkServiceType t 
This enumeration defines the service types of TAPI. 


Enumerator: 


ТАРІ NETWORK SERVICE TYPE NO SVE Мо service (This enumeration is not applicable for 
ОЕМ TAPI NW select network req API) 


TAPI NETWORK SERVICE TYPE LIMITED Limited service available in the camped network 
(This enumeration is not applicable for ОЕМ TAPI NW select network req API) 


TAPI NETWORK SERVICE TYPE CS CS service available in the camped network 
TAPI NETWORK SERVICE TYPE PS PS service available in the camped network 


TAPI NETWORK SERVICE TYPE COMBINED Both CS and PS services available in the 
camped network 


5.159.2.10 enum TelNetworkSystemIdFormat t 
This enumeration defines the System ID Formats. 


Enumerator: 


TAPI NETWORK SYSID FORMAT SID System ID in СОМА. 
TAPI NETWORK SYSID FORMAT PLMN PLMN id in GSM/3G 


5.159.2.11 enum TelNetworkSystemType t 
This enumeration defines the system types of TAPI. 


Enumerator: 


ТАРІ NETWORK SYSTEM NO SRV No Service available 

TAPI NETWORK SYSTEM CDMA Available service is CDMA 

TAPI NETWORK SYSTEM TDMA Available service is ТОМА 

TAPI NETWORK SYSTEM GSM Available service is GSM 

TAPI NETWORK SYSTEM GPRS Available service is GPRS 

TAPI NETWORK SYSTEM EGPRS Available service is EGPRS 

ТАРІ NETWORK SYSTEM PCS1900 Available service is PCS1900 band 

TAPI NETWORK SYSTEM UMTS Available service is UMTS 

TAPI NETWORK SYSTEM GSM AND UMTS Both GSM and UMTS systems available 
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5.160 SIM Data Structures 


Files 


* file TelSim.h 


This file serves as a "C" header file defines structures for Tapi SIM Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelSimFileID t 

struct TelSimPinData t 

struct TelSimReadFileRequestData, t 
struct TelSimIccIdInfo. t 


struct TelSimImsiInfo t 


struct TelSimServiceTable t 


struct TelSimSstInfo t 


struct TelSimPinInfo t 

struct TelSimPb2gData t 
struct TelSimPbRecordData t 
struct TelSimEccInfo t 

struct TelUsimEccInfo t 
struct TelUSimServiceTable t 


struct TelSimUstInfo t 

struct TelSimPbStorageInfo t 
struct TelSimPbEntryInfo t 
struct TelSimPbReadResp t 
struct TelSimPbUpdateResp t 


struct TelSimLanguagelInfo t 
struct TelSimFileAccessGeneralResp t 


struct TelSimGroupldentifierInfo t 
struct TelSimEccData t 

struct TelSimStatusData t 

struct TelSimCallbackEvent t 
struct TelSimEvent t 

struct TelSimApnData t 


struct TelSimDeviceContextData t 


struct TelSimDeviceContext t 

struct TelSimFileInfo t 

struct TelSimReadFileData t 

struct TelSimUpdateFileRequestData t 
struct TelSimFileInfo t 
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Defines 


fdefine TAPI SIM PIN LENGTH 8 

#define TAPI SIM ICCIDLENGTH 10 

#define TAPI SIM ICCID PACKET LEN 10 

#define TAPI SIM ICCID MAX LEN 10 

#define TAPI SIM LP MAX LEN 30 

#define TAPI SIM LP PACKET MAX LEN 30 

#define ТАРІ SIM IMSI LEN 8 

#define TAPI SIM IMSI PACKET LEN 15 

#define ТАРІ SIM MCC CODE LEN 3 

#define TAPI SIM MNC CODE LEN 2 

#define TAPI SIM MSIN CODE LEN 10 

#define TAPI SIM NUM TEXT MAX LEN 256 

#define TAPI SIM SST MAX LEN 20 

#define TAPI SIM GSM SST SERVICE MAX COUNT 50 
fdefine TAPI SIM ECC CODE LEN 3 

fdefine TAPI SIM ECC ALPHA STRING LEN MAX 50 
#define ТАРІ TAPI SIM PBOOK ENTRY COUNT MAX 20 
fdefine TAPI SIM LI MAX LEN 30 

fdefine TAPI SIM LI PACKET MAX LEN 30 

#define TAPI SIM ACL MAX LEN 50 

#define TAPI SIM GROUP IDENTIFIER LEN MAX 10 
#define TAPI SIM ECC MAX LEN 15 

#define ТАРІ SIM UECC RECORD COUNT МАХ 5 
fdefine TAPI SIM UECC RECORD LEN MAX 50 


Enumerations 


enum TelSimCardType t ( TAPI SIM CARD TYPE UNKNOWN, TAPI SIM CARD TYPE - 
GSM, TAPI SIM CARD TYPE USIM } 

enum TelSimFileName t { 

TAPI SIM EFILE DIR = Ox2F00, TAPI SIM EFILE ICCID = Ox2FE2, TAPI SIM EFILE - 
ADN = 0x6F3A, ТАРІ SIM, EFILE FDN = 0x6F3B, 

TAPI SIM EFILE SMS = 0x6F3C, ТАРІ SIM. ЕЕП,Е CCP = 0x6F3D, ТАРІ SIM. ЕЕП,Е IMSI 
= 0х6Е07, ТАРІ SIM EFILE, SST = Ox6F38, 

TAPI SIM EFILE EST = 0х6Е56, ТАРІ SIM EFILE АСМ = 0х6Е39, TAPI SIM EFILE - 
MBDN = 0x6FC7, TAPI SIM  EFILE GIDI = Ox6F3E, 

TAPI SIM EFILE GID2 = Ox6F3F, TAPI SIM. EFILE. MSISDN = 0x6F40, TAPI SIM. EFILE - 
SMSP = 0x6F42, ТАРІ SIM EFILE, SMSS = Ox6F43, 

ТАРІ SIM EFILE ЕХТІ = 0x6F4A, TAPI SIM. ЕЕП,Е EXT2 = 0х6ҒАВ, TAPI SIM. EFILE LP 
= Ox2F05, ТАРІ SIM EFILE, ACM. MAX = 0x6F37, 

TAPI SIM EFILE РОСТ = 0х6Е41, ТАРІ SIM EFILE. CBMI = Ox6F45, ТАРІ SIM EFILE - 
PHASE = Ox6FAE, TAPI SIM. EFILE. SDN = Ox6F49, 

ТАРІ SIM EFILE EXT3 = 0x6F4C, ТАРІ SIM, EFILE BDN = 0х6ҒАр, ТАРІ SIM EFILE - 
EXTA = Ox6F4E, TAPI SIM, EFILE, ECC = 0x6FB7, 


TAPI SIM EFILE SPN = Ox6F46, ТАРІ SIM ЕЕП Е РММ = Ox6FC5, ТАРІ SIM EFILE IMG 
= Ox4F20, ТАРІ SIM EFILE USIM LI = 0x6F05, 
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TAPI SIM EFILE USIM IMSI = 0x6A07, ТАРІ SIM EFILE USIM АСМ MAX = 0x6A37, 
TAPI SIM. EFILE USIM UST = 0x6A38, ТАРІ SIM EFILE USIM ACM = 0x6A39, 


TAPI SIM EFILE USIM SPN - 0x6A46, TAPI SIM EFILE USIM PUCT - 0x6A41, TAPI - 
SIM. EFILE USIM CBMI = 0x6A45, ТАРІ SIM EFILE USIM ECC = 0x6AB7, 


TAPI SIM EFILE USIM FDN = 0x6A3B, TAPI SIM EFILE USIM SMS = 0x6A3C, TAPI - 
SIM. EFILE USIM MSISDN = 0x6A40, ТАРІ SIM EFILE (ЗІМ SMSP = 0x6A42, 


TAPI SIM EFILE USIM SMSS = 0x6A43, ТАРІ SIM EFILE USIM SDN = 0x6A49, ТАРІ - 
SIM. EFILE USIM EXTI = 0X6A4A, ТАРІ SIM EFILE USIM EXT? = 0x6A4B, 


TAPI SIM EFILE USIM EXT3 = 0x6A4C, ТАРІ SIM ЕЕП Е USIM EXTA = 0x6A55, ТАРІ - 
SIM EFILE USIM ЕХТ5- 0x6A4E, ТАРІ SIM EFILE USIM ЕХТ6- 0x6FC8, 


ТАРІ SIM EFILE USIM CCP2 = 0x6A4F, ТАРІ SIM EFILE USIM HIDDEN KEY = 
Ox6FC3, ТАРІ SIM EFILE USIM BDN = 0х6А4р, ТАРІ SIM EFILE USIM MBDN 
Ox6FC7, 


ТАРІ SIM. EFILE USIM MBI = 0x6FC9, ТАРІ SIM EFILE USIM РНОМЕВООК РВК = 
Ox4FFO, ТАРІ SIM EFILE USIM PHONEBOOK ССРІ = Ox4FFE, ТАРІ SIM EFILE USIM - 
PHONEBOOK UID = 0x4FF8, 


TAPI SIM EFILE USIM PHONEBOOK PSC =  Ox4FFEB ТАРІ SIM EFILE ОІМ - 
PHONEBOOK CC = Ox4FEF, ТАРІ SIM EFILE USIM PHONEBOOK PUID = Ox4FEE, 
ТАРІ SIM. EFILE USIM PHONEBOOK ADN = 0x4FF1, 


TAPI SIM EFILE USIM PHONEBOOK ТАР =  Ox4FF2, TAPI SIM EFILE USIM - 
РНОМЕВООК РВС = 0х4ЕЕЗ, ТАРІ SIM EFILE USIM PHONEBOOK ЕХТІ = Ox4FFB, 
ТАРІ SIM. EFILE USIM РНОМЕВООК СКР = Ox4FF7, 


TAPI SIM EFILE USIM PHONEBOOK AAS =  Ox4FFC, ТАРІ SIM EFILE USIM - 
PHONEBOOK_AAS1 = Ox4FFD, ТАРІ SIM EFILE USIM PHONEBOOK GAS = O0x4FOE, 
TAPI SIM. EFILE USIM PHONEBOOK GASI = Ox4FOF, 


ТАРІ SIM EFILE USIM PHONEBOOK АМК =  Ox4FF4, TAPI SIM EFILE USIM - 
PHONEBOOK SNE = Ox4FF9, ТАРІ SIM EFILE USIM PHONEBOOK EMAIL = Ox4FFA, 
TAPI SIM EFILE USIM PHONEBOOK ANRA = Ox4F13, 


TAPI SIM EFILE USIM PHONEBOOK ANRB = 0х4Е14, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRC = Ox4F15, ТАРІ SIM EFILE USIM РНОМЕВООК ANRI = Ox4F16, 
TAPI SIM. EFILE USIM PHONEBOOK ANRAI = 0x4F17, 


ТАРІ SIM EFILE USIM PHONEBOOK АМКВІ = Ox4F18, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRCI = Ox4F21, ТАРІ SIM EFILE USIM РНОМЕВООК ADNI = Ox4F1A, 
ТАРІ SIM. EFILE USIM PHONEBOOK РВСІ = 0x4F1B, 


TAPI SIM EFILE USIM РНОМЕВООК СЕРІ =  Ox4FIC, ТАРІ SIM EFILE USIM - 
РНОМЕВООК SNEI! = Ox4FID, ТАРІ SIM EFILE USIM PHONEBOOK UIDI = Ox4FIE, 
ТАРІ SIM EFILE USIM РНОМЕВООК EMAILI = Ox4F1F, 


TAPI SIM EFILE USIM PHONEBOOK ТАРІ = 0х4ЕЕ5, ТАРІ SIM EFILE TELECOM - 
PHONEBOOK PBR = 0x4F30, TAPI SIM EFILE TELECOM РНОМЕВООК РВКІ = 0x4F29, 
ТАРІ SIM EFILE TELECOM PHONEBOOK РВК2 = 0x4F28, 


ТАРІ SIM EFILE TELECOM PHONEBOOK CCP] =  Ox4F3D, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK UID = Ox4F00, TAPI SIM EFILE TELECOM PHONEBOOK PSC 
= Ox4F22, ТАРІ SIM EFILE TELECOM PHONEBOOK CC = 0x4F23, 


ТАРІ SIM EFILE TELECOM PHONEBOOK PUID = 0х4Е24, TAPI SIM EFILE - 
TELECOM PHONEBOOK ADN = 0x4F3A, TAPI SIM EFILE TELECOM PHONEBOOK - 
ТАР = 0х4Е25, TAPI SIM EFILE TELECOM PHONEBOOK PBC = 0x4F09, 


TAPI SIM EFILE TELECOM PHONEBOOK EXTI =  Ox4F4A, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK GRP = 0х4Е26, TAPI SIM EFILE TELECOM PHONEBOOK - 
AAS = 0x4F4B, ТАРІ SIM EFILE TELECOM PHONEBOOK GAS = 0x4F4C, 
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ТАРІ SIM EFILE TELECOM PHONEBOOK АМА =  Ox4Fll, TAPI SIM EFILE - 
TELECOM PHONEBOOK SNE = 0x4F19, TAPI SIM EFILE TELECOM PHONEBOOK - 
EMAIL = Ox4F50, ТАРІ SIM EFILE TELECOM PHONEBOOK ANRA = 0x4F31, 


ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB =  Ox4F32, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ANRC = Ox4F40, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
ANRI = Ox4F33, ТАРІ SIM EFILE TELECOM, РНОМЕВООК ANRAI = 0x4F34, 
ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB1 =  Ox4F35, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ADNI = Ox4F36, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
РВСІ = Ox4F37, TAPI SIM EFILE TELECOM. РНОМЕВООК СЕРІ = 0x4F38, 
ТАРІ SIM EFILE TELECOM PHONEBOOK SNEI = Ox4F39, ТАРІ SIM. EFILE - 
TELECOM РНОМЕВООК UID1 = Ox4F3B, ТАРІ SIM EFILE TELECOM. PHONEBOOK - 
EMAIL] = 0x4F3C, ТАРІ SIM EFILE TELECOM, PHONEBOOK ТАРІ = Ox4F3E, 

TAPI SIM EFILE MSG WAITING INDICATION STATUS =  0x6FCA, ТАРІ SIM - 
EFILE INVALID = OxFFFF, ТАРІ SIM EFILE, OTHERS } 

enum TelSimFileType t { 

TAPI SIM FTYPE DEDICATED - 0x00, TAPI SIM FTYPE TRANSPARENT - 0x01, TAPI - 
SIM. FTYPE LINEAR FIXED - 0x02, TAPI SIM FTYPE CYCLIC - 0x04, 

ТАРІ SIM, FTYPE INVALID TYPE = OxFF } 

enum TelSimRecordMode t ( 

TAPI SIM. RECORD NONE = 0x00, TAPI SIM RECORD ABSOLUTE = 0x01, TAPI SIM - 
RECORD. CURRENT = 0x02, TAPI SIM. RECORD NEXT = 0x03, 

TAPI SIM RECORD PREVIOUS = 0x04, TAPI SIM, RECORD TO THE LAST = 0x05, 
TAPI SIM RECORD FROM, THE FIRST - 0x06 } 

enum TelSimPinStatus t { 

TAPI SIM. PIN STATUS DISABLED = 0x00, ТАРІ SIM PIN STATUS ENABLED = 0x01, 
TAPI SIM. PIN STATUS BLOCKED = 0x02, ТАРІ SIM. PIN STATUS РОК BLOCKED = 
0x03, 
ТАРІ SIM PIN STATUS UNKNOWN = OxFF } 

enum TelSimPinOperationResult t { 

TAPI SIM. PIN OPERATION SUCCESS, ТАРІ SIM, BUSY STATUS, ТАРІ SIM. CARD - 
ERROR, STATUS, TAPI SIM, INCOMPATIBLE PIN. OPERATION STATUS, 

TAPI SIM. PIN ІМСОККЕСТ PASSWORD STATUS, TAPI SIM. PIN2 REQD STATUS, 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS, ТАРІ SIM. РОК INCORRECT. - 
PASSWORD STATUS, 

ТАРІ SIM. РОК REQD STATUS, ТАРІ SIM, PUK2 REQD STATUS ) 

enum TelSimAccessResult_t ( 

TAPI SIM. ACCESS. SUCCESS, ТАРІ SIM. ACCESS CARD ERROR, ТАРІ SIM, ACCESS - 
FILE NOT. FOUND, TAPI SIM ACCESS ACCESS CONDITION МОТ SATISFIED, 

TAPI SIM. ACCESS FAILED } 

enum TelSimPinType t { 

TAPI SIM PTYPE РІМІ = 0x00, ТАРІ SIM. PTYPE PIN2 = 0x01, ТАРІ SIM PTYPE РОКІ = 
0x02, ТАРІ SIM. PTYPE РОК2 = 0x03, 

TAPI SIM, PTYPE UPIN = 0x04, TAPI SIM PTYPE ADM = 0x05 } 

enum TelSimTypeOfNum t { 

TAPI SIM TON UNKNOWN = 0, TAPI SIM TON INTERNATIONAL = 1, TAPI SIM TON - 
NATIONAL = 2, ТАРІ SIM, TON. NETWORK, SPECIFIC = 3, 

TAPI SIM TON DEDICATED ACCESS = 4, ТАРІ SIM, TON. ALPHA, NUMERIC - 5, TAPI - 
SIM, TON ABBREVIATED NUMBER = 6, ТАРІ SIM TON RESERVED FOR EXT 27] 
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enum  TelSimTextEncrypt t { ТАРІ SIM TEXT ЕМС ASCIL ТАРІ SIM TEXT ENC - 
GSM7BIT, ТАРІ SIM TEXT ЕМС UCS2, ТАРІ SIM TEXT ЕМС HEX } 
enum TelSimPbFileType t { 


TAPI SIM PB FDN, TAPI SIM PB LDN, TAPI SIM PB MSISDN, TAPI SIM PB ADN, 


TAPI SIM PB SDN } 

enum TelSimPbAccessMode t { TAPI SIM PB ACCESS MODE ADD = 0x01, TAPI SIM - 
PB ACCESS MODE DEL = 0x02, ТАРІ SIM PB ACCESS МОРЕ EDIT = 0x03 } 

enum TelSimNumberingPlanldentity t { 

TAPI SIM NPI UNKNOWN = 0, TAPI SIM NPI ISDN TEL = 1, TAPI SIM NPI DATA - 
NUMBERING PLAN = 3, ТАРІ SIM NPI TELEX = 4, 

TAPI SIM NPI SVC CNTR SPECIFIC PLAN - 5, TAPI SIM NPI SVC CNTR SPECIFIC - 
PLAN? = 6, ТАРІ SIM NPI NATIONAL = 8, ТАРІ SIM NPI PRIVATE = 9, 

TAPI SIM NPI ERMES NUMBERING PLAN = 10, TAPI SIM NPI RESERVED FOR EXT 
= OxF } 

enum TelSimEccEmergencyServiceInfo t { 

TAPI SIM ECC ESC POLICE = 0x01, TAPI SIM ECC ESC AMBULANCE = 0x02, TAPI - 
SIM. ECC ESC FIREBRIGADE = 0x03, ТАРІ SIM ECC Е5С MARAINEGUARD = 0x04, 
ТАРІ SIM ECC ESC MOUTAINRESCUE = 0x05, ТАРІ SIM ECC ESC SPARE = 0x00 } 
enum TelSimPbAccessResult. t ( 


TAPI SIM PB SUCCESS, TAPI SIM PB FAIL, TAPI SIM PB INVALID INDEX, TAPI - 
SIM PB INVALID NUMBER LENGTH, 


TAPI SIM. PB. INVALID NAME LENGTH, ТАРІ SIM PB ACCESS CONDITION. NOT - 
SATISFIED } 

enum TelSimLanglIndicationCode t { 

TAPI SIM LI GERMAN = О, TAPI SIM LI ENGLISH = 0x01, TAPI SIM LI ITALIAN = 
0x02, TAPI SIM. LI FRENCH = 0x03, 

ТАРІ SIM. LI SPANISH = 0x04, ТАРІ SIM LI DUTCH = 0x05, ТАРІ SIM. LI SWEDISH = 
0x06, TAPI SIM. LI DANISH - 0x07, 

TAPI SIM LI PORTUGUESE = 0x08, TAPI SIM LI FINNISH = 0x09, TAPI SIM LI - 
NORWEGIAN = 0x0A, ТАРІ SIM 11 GREEK = OxOB, 

ТАРІ SIM LI TURKISH = 0xOC, ТАРІ SIM, LI HUNGARIAN = O0xOD, ТАРІ SIM LI - 
POLISH = OxOE, ТАРІ SIM LI LANG UNSPECIFIED = OxOF } 

enum TelSimAccessType t { 

TAPI SIM SELECT, TAPI SIM READ BINARY, TAPI SIM READ RECORD, TAPI SIM - 
СЕТ RESPONSE, 

TAPI SIM. UPDATE BINARY, ТАРІ SIM, UPDATE RECORD, ТАРІ SIM, STATUS } 

enum TelSimCardStatus t { 

TAPI SIM. STATUS CARD ERROR = 0x00, TAPI SIM, STATUS CARD NOT PRESENT = 


0x01, TAPI SIM STATUS SIM INITIALIZING = 0x02, TAPI SIM. STATUS SIM INIT - 
COMPLETED = 0x03, 


TAPI SIM, STATUS SIM PIN REQUIRED = 0x04, TAPI SIM, STATUS SIM PUK - 
REQUIRED = 0x05, ТАРІ SIM STATUS CARD BLOCKED = 0x06 } 

enum TelSimAcl t { 

TAPI SIM, АСІ, ALW = 0x00, ТАРІ SIM, ACL РІМІ = 0x01, ТАРІ SIM, ACL PIN2 = 0x02, 
TAPI SIM, ACL КЕС = 0x04, 


TAPI SIM ACL ADM = 0x08, TAPI SIM ACL NEVER = OxFF } 
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5.160.1 Define Documentation 


5.160.1.1 #define ТАРІ SIM ACL MAX LEN 50 


Maximum ACL length 


5.160.1.2 #define ТАРІ SIM ECC ALPHA STRING LEN MAX 50 


Maximum ECC Alpha string length 


5.160.1.3 define ТАРІ SIM ECC CODE LEN3 


Maximum ECC code length 


5.160.1.4 #ебпе ТАРІ SIM ECC MAX LEN 15 


Maximum ECC length 


5.160.1.5 #define ТАРІ SIM GROUP IDENTIFIER LEN МАХ 10 


Maximum group identifier length 


5.160.1.6 define ТАРІ SIM GSM SST SERVICE MAX COUNT 50 


Maximum SST service count 


5.160.1.7 #define ТАРІ SIM ICCID MAX LEN 10 


Maximum length of ICCID 


5.160.1.8 define ТАРІ SIM ICCID PACKET LEN 10 


ICCID Packet Length 


5.160.1.9 #ебпе ТАРІ SIM ICCIDLENGTH 10 


ICCID Length 


5.160.1.10 define ТАРІ SIM IMSI LEN 8 


IMSI length 


5.160.1.11 #ебпе ТАРІ SIM IMSI PACKET LEN 15 


maximum IMSI packet length 
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5.160.1.12 define ТАРІ SIM LI MAX LEN 30 


Maximum Language indication length 


5.160.1.13 define ТАРІ SIM LI PACKET MAX LEN 30 


maximum LI Packet length 


5.160.1.14 define ТАРІ SIM LP МАХ LEN 30 


Language preference maximum length 


5.160.1.15 #define ТАРІ SIM LP PACKET MAX LEN 30 


Language preference packet maximum length 


5.160.1.16 define ТАРІ SIM MCC CODE LEN3 


maximum MCC code length 


5.160.1.17 define ТАРІ SIM ММС CODE LEN 2 


maximum MNC Code length 


5.160.1.18 define ТАРІ SIM MSIN CODE LEN 10 


Maximum MSIN code length 


5.160.1.19 #еһпе ТАРІ SIM NUM TEXT MAX LEN 256 


Maximum Text length for number 


5.160.1.20 #define ТАРІ SIM PIN LENGTH 8 


max length for PIN 


5.160.1.21 define ТАРІ SIM SST MAX LEN 20 


Maximum SST code length 


5.160.1.22 #define ТАРІ SIM UECC RECORD COUNT МАХ 5 


Maximum UECC Record count 
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5.160.1.23 #еһпе ТАРІ SIM UECC RECORD LEN МАХ 50 


Maximum UECC record length 


5.160.1.24 define ТАРІ ТАРІ SIM PBOOK ENTRY COUNT MAX 20 


max 254 entries within a record of PBR 


5.160.2 Enumeration Type Documentation 


5.160.2.1 enum TelSimAccessResult_t 


This enumeration defines the SIM access result from the lower layers. 


Enumerator: 


TAPI_SIM_ACCESS_SUCCESS Access to file successful. 
TAPI SIM ACCESS CARD ERROR Sim card error 
TAPI SIM ACCESS FILE NOT FOUND File not found 


TAPI SIM ACCESS ACCESS CONDITION NOT SATISFIED Access condition is not ful- 
filled 


TAPI SIM ACCESS FAILED Access failed. 


5.160.2.2 enum TelSimA ccessType t 


This enumeration defines the access type information. 


Enumerator: 


TAPI SIM SELECT Select SIM 

TAPI SIM READ BINARY Read binary file 
TAPI SIM READ RECORD Read record 
TAPI SIM GET RESPONSE Get response 
TAPI SIM UPDATE BINARY Update binary 
TAPI SIM UPDATE RECORD Update record 
TAPI SIM STATUS SIM status 


5.160.2.3 enum TelSimAcl t 


This enumeration defines the ACL. 
Enumerator: 


ТАРІ SIM ACL ALW ALWays 

TAPI SIM ACL PINI PIN 1 

TAPI SIM ACL PIN2 PIN2 
TAPI SIM ACL RFU RFU 

TAPI SIM ACL ADM Administration Key 
TAPI SIM ACL NEVER Never 
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5.160.2.4 enum TelSimCardStatus t 


This enumeration defines the SIM card status 


Enumerator: 
TAPI SIM STATUS CARD ERROR Bad card / On the fly SIM gone bad 
TAPI SIM STATUS CARD NOT PRESENT Card not present / removed 
TAPI SIM STATUS SIM INITIALIZING Sim is Initializing state 
TAPI SIM STATUS SIM INIT COMPLETED Sim Initialization ok 
TAPI SIM STATUS SIM PIN REQUIRED PIN required state 
TAPI SIM STATUS SIM PUK REQUIRED РОК required state 


TAPI SIM STATUS CARD BLOCKED  PIN/PUK blocked(permanently blocked- АП the at- 
tempts for PIN/PUK failed) 


5.160.2.5 enum TelSimCardType t 
This enumeration defines the card type. 


Enumerator: 
ТАРІ SIM CARD TYPE UNKNOWN Unkown card 
TAPI SIM CARD TYPE GSM Gsm card 
TAPI SIM CARD TYPE USIM Usim card 


5.160.2.6 enum TelSimEccEmergencyServiceInfo t 
This enumeration defines the emergency service type. 


Enumerator: 


TAPI SIM ECC ESC POLICE Police 

TAPI SIM ECC ESC AMBULANCE Ambulance 

TAPI SIM ECC ESC FIREBRIGADE Fire brigade 

TAPI SIM ECC ESC MARAINEGUARD Marine guard 
TAPI SIM ECC ESC MOUTAINRESCUE Mountain rescue 
TAPI SIM ECC ESC SPARE Spare 


5.160.2.7 enum TelSimFileName t 


This enumeration defines the file id. 


Enumerator: 
TAPI SIM EFILE DIR for the USIM 
TAPI SIM EFILE ICCID the ICC Identification file 
TAPI SIM EFILE ADN the Abbrv. Dialing Num file 
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TAPI SIM EFILE FDN the Fixed Dialing Num file 
ТАРІ SIM EFILE SMS the Short Messages file 

TAPI SIM EFILE CCP the Capab. Config Param file 
ТАРІ SIM EFILE IMSI the IMSI file 

TAPI SIM EFILE SST the SIM Service Table file 
TAPI SIM EFILE EST the Extended Service Table File 
TAPI SIM EFILE ACM the Accumul. Call Meter file 
TAPI SIM EFILE MBDN SIM Mail Box Dailing Number file 
ТАРІ SIM EFILE GIDI the Group Identifier Level 1 
TAPI SIM EFILE GID2 the Group Identifier Level 2 
TAPI SIM EFILE MSISDN the MSISDN file 

TAPI SIM EFILE SMSP the Short Msg Srv. Param file 
TAPI SIM EFILE SMSS the SMS Status 


TAPI SIM EFILE EXTI 


the Extension 1 file 


TAPI SIM EFILE EXT2 the Extension 2 file 
TAPI SIM EFILE LP the Language Preference file 


TAPI SIM EFILE ACM MAX 


the ACM maximum value file 


TAPI SIM EFILE PUCT the Price per Unit and. file 
TAPI SIM EFILE CBMI the Cell Brd msg Id sel file 
TAPI SIM EFILE PHASE the PHASE identification file 
TAPI SIM EFILE SDN the Service Dialing Numbers 
TAPI SIM EFILE ЕХТЗ the Extension 3 file 

TAPI SIM EFILE BDN the BDN file 

ТАРІ SIM EFILE EXT4 the Extension 4 file 

TAPI SIM EFILE ECC the Emergency Call Codes 
TAPI SIM EFILE SPN the Service Provider Name 
TAPI SIM EFILE PNN the Service Provider Name 
TAPI SIM EFILE IMG image 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM LI Language Indication 
USIM IMSI IMSI 


TAPI SIM EFILE 


USIM ACM MAX ACM maximum value 


TAPI SIM EFILE 


USIM UST USIM Service Table 


TAPI SIM EFILE 


USIM ACM Accumulated Call Meter 


TAPI SIM EFILE 


USIM SPN Service Provider Name 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PUCT Price per Unit and Currency Table 
USIM CBMI Cell Broadcaster Message Identifier selection 


TAPI SIM EFILE 


USIM ECC Emergency Call Codes 


TAPI SIM EFILE 


USIM FDN Fixed Dialing Number 


TAPI SIM EFILE 


USIM SMS USIM SMS 


TAPI SIM EFILE 


USIM MSISDN USIM MSISDN 


TAPI SIM EFILE 


USIM SMSP USIM SMSP 
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TAPI SIM EFILE 


USIM SMSS USIM SMSS 


TAPI SIM EFILE 


USIM SDN USIM SDN 


TAPI SIM EFILE 


USIM ЕХТІ USIM ЕХТІ 


TAPI SIM EFILE 


USIM EXT2 USIM EXT2 


TAPI SIM EFILE 


USIM EXT3 USIM EXT3 


TAPI SIM EFILE 


(“ІМ ЕХТ4 USIM EXTA 


TAPI SIM EFILE 


USIM EXTS5 Extension 5 


TAPI SIM EFILE 


USIM CCP2 Capability Configuration Parameters 2 


TAPI SIM EFILE 


USIM HIDDEN KEY Key for hidden phonebook entries 


TAPI SIM EFILE 


USIM BDN Barred Dialing Numbers 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM MBDN USIM Mail box dialing number 
USIM MBI Mailbox Identifier 


TAPI SIM EFILE 


USIM PHONEBOOK PBR Phonebook Reference File 


TAPI SIM EFILE 


USIM РНОМЕВООК CCPI Capability Configuration Parameters 1 


TAPI SIM EFILE 


USIM PHONEBOOK UID unique identifier 


TAPI SIM EFILE 


USIM PHONEBOOK PSC phonebook synchronization counter 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK CC change counter 
USIM PHONEBOOK PUID previous unique identifier 


TAPI SIM EFILE 


USIM PHONEBOOK ADN Abbreviated Dialing Number 


TAPI SIM EFILE 


USIM PHONEBOOK IAP Index Administration Phonebook 


TAPI SIM EFILE 


USIM PHONEBOOK PBC Phonebook Control 


TAPI SIM EFILE 


USIM PHONEBOOK EXTI Extension 1 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK GRP Grouping File 
USIM PHONEBOOK AAS Additional number Alpha String 


TAPI SIM EFILE 


USIM PHONEBOOK AASI Additional number Alpha String 


TAPI SIM EFILE 


USIM PHONEBOOK GAS Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK GASI Second Name Entry 


TAPI SIM EFILE 


USIM PHONEBOOK АМК Additional Number 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK SNE Second Name Entry 
USIM PHONEBOOK EMAIL e-mail address 


TAPI SIM EFILE 


USIM PHONEBOOK ANRA Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRB Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRC Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRAI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRBI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRCI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ADNI  Abbreviated Dialing Number 


TAPI SIM EFILE 


USIM PHONEBOOK РВСІ Phonebook Control 


TAPI SIM EFILE 


USIM PHONEBOOK СЕРІ Grouping File 


TAPI SIM EFILE 


USIM PHONEBOOK SNEI Second Name Entry 
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TAPI SIM EFILE USIM PHONEBOOK UIDI unique identifier 

ТАРІ SIM EFILE USIM PHONEBOOK EMAILI e-mail address 

ТАРІ SIM EFILE USIM PHONEBOOK IAPI Index Administration Phonebook 
TAPI SIM EFILE TELECOM PHONEBOOK PBR  Phonebook Reference File 

TAPI SIM EFILE TELECOM PHONEBOOK PBRI Phonebook Reference File 1 
TAPI SIM EFILE TELECOM PHONEBOOK PBR2 Phonebook Reference File 1 
TAPI SIM EFILE TELECOM PHONEBOOK CCPI Capability Configuration Parameters 1 
ТАРІ SIM EFILE TELECOM PHONEBOOK UID unique identifier 

TAPI SIM EFILE TELECOM PHONEBOOK PSC  Phonebook synchronization counter 
TAPI SIM EFILE TELECOM PHONEBOOK CC change counter 

TAPI SIM EFILE TELECOM PHONEBOOK PUID previous unique identifier 
TAPI SIM EFILE TELECOM PHONEBOOK ADN Abbreviated Dialing Number 
TAPI SIM EFILE TELECOM PHONEBOOK ТАР Index Administration Phonebook 
TAPI SIM EFILE TELECOM PHONEBOOK PBC Phonebook Control 

TAPI SIM EFILE TELECOM PHONEBOOK EXTI Extension 1 

TAPI SIM EFILE TELECOM PHONEBOOK GRP Grouping File 

TAPI SIM EFILE TELECOM PHONEBOOK AAS Additional number Alpha String 
TAPI SIM EFILE TELECOM PHONEBOOK GAS Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANR Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK SNE Second Name Entry 

TAPI SIM EFILE TELECOM PHONEBOOK EMAIL e-mail address 

TAPI SIM EFILE TELECOM PHONEBOOK ANRA Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRB Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRC Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRI Additional Number 

ТАРІ SIM EFILE TELECOM PHONEBOOK ANRAI Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRBI Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ADNI  Abbreviated Dilling Number 
TAPI SIM EFILE TELECOM PHONEBOOK PBCI Phonebook Control 

TAPI SIM EFILE TELECOM PHONEBOOK СЕРІ Grouping File 

TAPI SIM EFILE TELECOM PHONEBOOK SNEI Second Name Entry 

TAPI SIM EFILE TELECOM PHONEBOOK UIDI unique identifier 

ТАРІ SIM EFILE TELECOM PHONEBOOK EMAILI e-mail address 

TAPI SIM EFILE TELECOM PHONEBOOK ТАРІ Index Administration Phonebook 


TAPI SIM EFILE INVALID Elements enumerating (known) Elementary files in SIM like EF- 
DIR, EF-VGCS, EF-VBS, EF-PBR, EF-ADN, EF-IAP, EF-EXTI, EF-SNE, EF-ANR, EF-PBC, 
EF-GRP, EF-AAS, EF-GAS, EF-UID, EF-EMAIL, EF-CCP1, EF-PSC, EF-CC, EF-PUID, EF- 
FDN etc. 


TAPI SIM EFILE OTHERS Element to indicate an unknown file. 
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5.160.2.8 enum TelSimFileType t 
This enumeration defines the file type. 


Enumerator: 


TAPI SIM FTYPE DEDICATED Dedicated 


TAPI SIM FTYPE TRANSPARENT Transparent 
TAPI SIM FTYPE LINEAR FIXED Linear fixed 


TAPI SIM FTYPE CYCLIC Cyclic 


TAPI SIM FTYPE INVALID TYPE Invalid type 


5.160.2.9 enum TelSimLanglIndicationCode t 
This enumeration defines the language indication code. 


Enumerator: 


TAPI SIM LI GERMAN German 
TAPI SIM LI ENGLISH English 
ТАРІ SIM LI ITALIAN Italian 

TAPI SIM LI FRENCH French 

TAPI SIM LI SPANISH Spanish 

TAPI SIM LI DUTCH Dutch 

TAPI SIM LI SWEDISH Swedish 
TAPI SIM LI DANISH Danish 

TAPI SIM LI PORTUGUESE Portuguese 
TAPI SIM LI FINNISH Finnish 

TAPI SIM LI NORWEGIAN Norwegian 
TAPI SIM LI GREEK Greek 
TAPI SIM LI TURKISH Turkish 

TAPI SIM LI HUNGARIAN Hungarian 
TAPI SIM LI POLISH Posish 


TAPI SIM LI LANG UNSPECIFIED Unspecified 


5.160.2.10 enum TelSimNumberingPlanIdentity t 
This enumeration defines the numbering plan identifier. 


Enumerator: 


TAPI SIM NPI UNKNOWN Unknown 


ТАРІ SIM NPI ISDN TEL ISDN/Telephone numbering plan 
TAPI SIM NPI DATA NUMBERING PLAN Data numbering plan 


TAPI SIM NPI TELEX Telex numbering plan 


TAPI SIM NPI SVC CNTR SPECIFIC PLAN Service Center Specific plan 
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ТАРІ SIM NPI SVC CNTR SPECIFIC PLAN2 Service Center Specific plan 
TAPI SIM NPI NATIONAL National numbering plan 

TAPI SIM NPI PRIVATE Private numbering plan 

TAPI SIM NPI ERMES NUMBERING PLAN ERMES numbering plan 
TAPI SIM NPI RESERVED FOR EXT Reserved for extension 


5.160.2.11 enum TelSimPbA ccessMode t 


This enumeration defines modes to add,del,edit for phone book access 


Enumerator: 


TAPI SIM PB ACCESS MODE ADD Phone Book Access mode - Add entry 
TAPI SIM PB ACCESS MODE DEL Phone Book Access mode - Delete entry 
TAPI SIM PB ACCESS MODE EDIT Phone Book Access mode - edit entry 


5.160.2.12 enum TelSimPbA ccessResult t 


This enumeration defines the Phone book access result 


Enumerator: 


TAPI SIM PB SUCCESS SIM phonebook operation successful. 
TAPI SIM PB FAIL SIM phonebook operation failure. 
TAPI SIM PB INVALID INDEX The index passed was not a valid index. 


TAPI SIM PB INVALID NUMBER LENGTH The number length is exceecds the max length 
allowed (or 0). 


TAPI SIM PB INVALID NAME LENGTH The name length is exceecds the max length allowed 
(or 0). 


ТАРІ SIM PB ACCESS CONDITION NOT SATISFIED Access condition for PB file is not 
satisfied. 


5.160.2.13 enum TelSimPbFileType t 


This enumeration defines different storage types to be selected in SIM or USIM 


Enumerator: 


TAPI SIM PB FDN sim FDN 

TAPI SIM PB LDN sim last dialled num 

TAPI SIM PB MSISDN sim my own number - MSISDN list 
TAPI SIM PB ADN SIM- ADN 

ТАРІ SIM PB SDN Sim service dialing num 
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5.160.2.14 enum TelSimPinOperationResult t 
This enumeration defines the pin operation result from the lower layers. 


Enumerator: 


TAPI SIM PIN OPERATION SUCCESS Operation involving PIN (verifica- 
tion/change/enable/disable, etc) is successful. 


ТАРІ SIM BUSY STATUS 5ітп 15 busy 
TAPI SIM CARD ERROR STATUS Sim card error 


TAPI SIM INCOMPATIBLE PIN OPERATION STATUS Sim Incompatible pin operation that 
is in case when invalid SIM command is given or incorrect parameters are supplied to the SIM. 


TAPI SIM PIN INCORRECT PASSWORD STATUS Sim PIN Incorrect password 
ТАРІ SIM PIN2 REQD STATUS Sim PIN2 Required Status 

ТАРІ SIM PIN2 INCORRECT PASSWORD STATUS Sim PIN? Incorrect password 
TAPI SIM PUK INCORRECT PASSWORD STATUS Sim PUK Incorrect Password 
TAPI SIM PUK REQD STATUS РОК Required 

ТАРІ SIM PUK2 REQD STATUS PUK2 Required 


5.160.2.15 enum TelSimPinStatus t 
This enumeration defines the pin status. 


Enumerator: 
TAPI SIM PIN STATUS DISABLED PIN status Disabled 
TAPI SIM PIN STATUS ENABLED PIN status Enabled 


TAPI SIM PIN STATUS BLOCKED SIM is present, but PIN is blocked. Need unblocking by 
PUK 


TAPI SIM PIN STATUS PUK BLOCKED SIM is present, but PUK is blocked 
ТАРІ SIM PIN STATUS UNKNOWN ЅІМ is in unknown state 


5.160.2.16 enum TelSimPinType t 
This enumeration defines the pin type. 


Enumerator: 
TAPI SIM PTYPE PINI РІМІ 
ТАРІ SIM PTYPE PIN2 PIN2 
TAPI SIM PTYPE PUKI Puk! 
TAPI SIM PTYPE PUK2 Puk2 
TAPI SIM PTYPE UPIN Universal PIN 
TAPI SIM PTYPE ADM Administrator 
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5.160.2.17 enum TelSimRecordMode t 


This enumeration defines the record mode. 


Enumerator: 
TAPI SIM RECORD NONE N/A, meaning the target file isn't a record type 
TAPI SIM RECORD ABSOLUTE The specified record will be read or updated 
TAPI SIM RECORD CURRENT The current record will be read or updated 
TAPI SIM RECORD NEXT The next record will be read or updated 
TAPI SIM RECORD PREVIOUS The previous record will be read or updated 


TAPI SIM RECORD TO THE LAST АП records from the record specified by record index to 
the last one will be read to the last 


TAPI SIM RECORD FROM THE FIRST АП records from the first record to the one specified 
by record, index will be read from the first 


5.160.2.18 enum TelSimTextEncrypt t 
This enumertion defines the text encryption types 


Enumerator: 
TAPI SIM TEXT ENC ASCII ASCII Encoding 
ТАРІ SIM TEXT ЕМС GSM7BIT GSM 7 Bit Encoding 
TAPI SIM TEXT ENC UCS2 UCS2 Encoding 
TAPI SIM TEXT ENC HEX HEX Encoding 


5.160.2.19 enum TelSimTypeOfNum t 
This enumeration defines the type of number. 


Enumerator: 


ТАРІ SIM TON UNKNOWN unknown 

TAPI SIM TON INTERNATIONAL international number 

TAPI SIM TON NATIONAL national number 

TAPI SIM TON NETWORK SPECIFIC network specific number 

TAPI SIM TON DEDICATED ACCESS subscriber number 

TAPI SIM TON ALPHA NUMERIC alphanumeric, GSM 7-bit default alphabet) 
TAPI SIM TON ABBREVIATED NUMBER abbreviated number 

TAPI SIM TON RESERVED FOR EXT reserved for extension 
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5.161 SS DataStructures 


Files 


* file TelSs.h 


This file serves as a "C" header file defines structures for Tapi SS Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSsForwardInfo t 

struct TelSsUssdMsglInfo t 
struct TelSsCallBarringInfo t 
struct TelSsCliRecord t 

struct TelSsCallBarringRecord t 
struct TelSsForwardRecord. t 
struct TelSsCallWaitingRecord t 
union TelSsRecord t 

struct TelSsInfo t 

struct TelSsCapabilityInfo t 


Defines 


• #define ТАРІ SS С5М BARR PW LEN MAX 4 
• #define ТАРІ CALL DIALDIGIT LEN MAX 82 
* #define TAPI SS USSD DATA SIZE MAX 201 


Enumerations 


* enum TelSsForwardWhen t { 


TAPI SS FORWARD WHEN UNCONDITIONAL EV, TAPI SS FORWARD WHEN - 
BUSY EV, TAPI SS FORWARD WHEN NO ANSWER EV, TAPI SS FORWARD WHEN - 
NOT REACHABLE EV, 

TAPI SS FORWARD WHEN ALL FORWARDING EV } 

enum TelSsCallBarType t { 


TAPI CALL BARRING ALL, TAPI CALL ВАККІМС OUTGOING, TAPI CALL - 


ВАККІМС ALL OUTGOING. CALLS, TAPI CALL BARRING ALL OUTGOING - 
INTERN CALL, 
TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT, TAPI CALL - 


BARRING INCOMING, TAPI CALL BARRING ALL INCOMING CALLS, TAPI CALL - 
BARRING АШ, INCOMING CALLS  ROAMING, 

ТАРІ CALL BARRING. ALL INCOMING. CALLS INSIM } 

enum TelSsTeleService t { 

ТАРІ SS TS ALL TELE AND BEARER SERVICES, ТАРІ SS TS ALL TELESERVICES, 
ТАРІ SS TS АШ, SPEECH, ТАРІ SS TS ALL DATA TELESERVICES, 


TAPI SS TS FACS, ТАРІ SS TS ALL TELESERVICES EXCEPT SMS,  TAPI SS TS - 
ALL PLMN SPEC TELE, TAPI SS TS PLMN SPEC TELE 1, 
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TAPI SS TS PLMN SPEC TELE 2, TAPI SS TS PLMN SPEC TELE 3, TAPI SS TS - 
PLMN SPEC TELE 4, TAPI SS TS PLMN SPEC TELE 5, 

TAPI SS TS PLMN SPEC TELE 6, TAPI SS TS PLMN SPEC TELE 7, TAPI SS TS - 
PLMN SPEC TELE 8, TAPI SS TS PLMN SPEC TELE 9, 

TAPI SS TS PLMN SPEC TELE A, TAPI SS TS PLMN SPEC TELE B, TAPI SS TS - 
PLMN SPEC TELE C, TAPI SS TS PLMN SPEC TELE D, 

TAPI SS TS PLMN SPEC TELE E, TAPI SS TS PLMN SPEC TELE F, TAPI SS TS - 
PLMN SPEC TELE , TAPI SS BS ALL BEARER SERVICES, 

TAPI SS BS ALL DATA CDS, TAPI SS В5 ALL ASYNCHRONOUS, TAPI SS BS ALL - 
SYNCHRONOUS, TAPI SS BS DATA CIRCUIT SYNC, 

TAPI SS BS DATA CIRCUIT ASYNC, TAPI SS BS DATA ALL PDS, TAPI SS BS ALL - 
DATA. PADCA, ТАРІ SS BS ALL PLMN SPEC BS, 

TAPI SS BS PLMN SPEC TELE 1, TAPI SS BS PLMN SPEC TELE 2, TAPI SS BS - 
PLMN SPEC TELE 3, TAPI SS BS PLMN SPEC TELE 4, 

TAPI SS BS PLMN SPEC TELE 5, TAPI SS BS PLMN SPEC TELE 6, TAPI SS BS - 
PLMN SPEC TELE 7, TAPI SS BS PLMN SPEC TELE 8, 

TAPI SS BS PLMN SPEC TELE 9, TAPI SS BS PLMN SPEC TELE A, TAPI SS BS - 
PLMN SPEC TELE B, TAPI SS BS PLMN SPEC TELE C, 

TAPI SS BS PLMN SPEC TELE D, TAPI SS BS PLMN SPEC TELE E, TAPI SS BS - 
PLMN SPEC TELE F, TAPI SS TS ALL DATA, 

TAPI SS TS DATA CIRCUIT SYNC, TAPI SS TS MULTIPLE, TAPI SS TS TELEPHONY, 
TAPI SS TS DATA CIRCUIT ASYNC, 

TAPI SS TS DATA PACKET } 

enum TelSsUssdRespType t { TAPI USSD RES UNKNOWN ALPHABET, TAPI USSD - 
RES DISPL BUSY, ТАРІ USSD RES OK, ТАРІ USSD RES NONE } 

enum TelSsUssdIndType t ( 

ТАРІ USSD IND NOTIFY = 0x00, ТАРІ USSD IND NO ACTION REQUIRE = 0x01, ТАРІ - 
USSD IND. ACTION REQUIRE = 0x02, ТАРІ USSD IND TERMINATED BY NET = 0x03, 
ТАРІ USSD IND OTHER CLIENT = 0x04, ТАРІ USSD IND МОТ SUPPORT = 0x05, ТАРІ - 
USSD IND TIME OUT - 0x06 ] 

enum TelSsCallBarOperationMode t { TAPI SS CALL BAR ACTIVATE, TAPI SS CALL - 
ВАК DEACTIVATE } 

enum TelSsCallType t { 

TAPI CALL TYPE VOICE EV, TAPI CALL TYPE DATA EV, TAPI CALL TYPE FAX - 
EV, TAPI CALL TYPE SHORT MESS EV, 

ТАРІ CALL ТҮРЕ DATA CIRCUIT SYNC ЕУ) 

enum TelSsForwardMode t ( TAPI CALL FORWARD MODE DISABLE EV, TAPI CALL - 
FORWARD MODE ENABLE EV,  TAPI CALL FORWARD MODE REGISTRATION EV, 
TAPI CALL FORWARD MODE ERASURE EV } 

enum TelSsForwardType t { ТАРІ CS FORWARD ТҮРЕ VOICE EV = 0, ТАРІ CS - 
FORWARD TYPE DATA EV, ТАРІ CS FORWARD TYPE FAX ЕУ) 


enum  TelSsRestrictIDStatus t { ТАРІ CALL RESTRICT ID DEPEND NETWORK EV, 
ТАРІ CALL RESTRICT ID ENABLE EV, ТАРІ CALL RESTRICT ID DISABLE ЕУ) 


enum TelSsType t { 


TAPI 55 TYPE BARRING, TAPI 55 TYPE FORWARDING, ТАРІ 55 TYPE WAITING, 
TAPI SS TYPE IDENTIFICATION, 


ТАРІ 55 ТҮРЕ СМАР, TYPE SS TYPE USSD ) 
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enum TelSsCause t ( 


TAPI SS SUCCESS, TAPI SS TIMEREXPIRE, TAPI SS UNKNOWNSUBSCRIBER, TAPI - 
55 SERVICENOTPROVISIONED, 


TAPI SS CALLBARRED, TAPI SS ILLEGALSSOPERATION ERROR, TAPI SS - 
NOTAVAILABLE, ТАРІ 55 SUBSCRIPTIONVIOLATION, 


TAPI SS FACILITYNOTSUPPORTED, TAPI SS UNEXPECTEDDATAVALUE, ТАРІ SS - 
PWREGISTRATIONFAILURE, ТАРІ 55 NEGATIVEPWCHECK, 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION, TAPI SS UNKNOWNALPHABET, 
ТАРІ 55 USSDBUSY, ТАРІ 55 REJECTEDB YUSER, 


ТАРІ 55 REJECTEDBYNETWORK, ТАРІ SS INVALIDDEFLECTEDTONUMBER, ТАРІ - 
SS MAXNOMPTYEXCEEDED, TAPI SS RESOURCESNOTAVAILABLE, 


TAPI SS UNKNOWNERROR, TAPI SS OEM NOT SUPPORTED } 


enum TelSsStatus t ( 


TAPI SS STATUS ACTIVE, TAPI SS STATUS REGISTERED, TAPI SS STATUS - 
PROVISIONED, TAPI SS STATUS QUIESCENT, 


TAPI SS STATUS NOTHING } 
enum TelSsLineldentificationType_t { 


ТАРІ CALLING LINE IDENTITY PRESENTATION, TAPI_CALLING_LINE_IDENTITY_- 


RESTRICTION, TAPI CONNECTED LINE IDENTITY PRESENTATION, TAPI - 
CONNECTED LINE IDENTITY RESTRICTION, 

TAPI CALLED LINE IDENTITY PRESENTATION, ТАРІ CALLING. NAME - 
PRESENTATION } 


enum TelSsCliStatus, t { 


TAPI CLI STATUS NOT PROVISONED, TAPI CLI STATUS PROVISIONED, TAPI CLI - 
STATUS ACTIVATED, TAPI CLI STATUS UNKOWN, 
TAPI CLI STATUS TEMP RESTRICTED, TAPI CLI STATUS TEMP ALLOWED ] 


enum TelSsBarPwdType t { TAPI SS ВАК GET PWD, ТАРІ SS BAR NEW PWD, TAPI - 
SS BAR VERIFY NEW PWD } 


5.1611 Define Documentation 
5.161.1.1 #define ТАРІ CALL DIALDIGIT LEN МАХ 82 


maximum length of dial digit 


5.161.1.2 #ебпе ТАРІ SS GSM BARR PW LEN MAX 4 


maximum length of barring password 


5.161.1.3 #ебпе ТАРІ 55 USSD DATA SIZE MAX 201 


User-to-user data maximum size 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


224 Module Documentation 


5.161.2 Enumeration Type Documentation 
5.161.2.1 enum TelSsBarPwdType_t 
This enumeration defines the Bar password type. 


Enumerator: 
TAPI_SS_BAR_GET_PWD This password type indicates already set barring password 
TAPI SS BAR NEW PWD This password type indicates new password 
TAPI SS BAR VERIFY NEW PWD This password type indicates verifying new password 


5.161.2.2 enum TelSsCallBarOperationMode t 
This enumeration defines the call barring operation mode . 


Enumerator: 


TAPI SS CALL BAR ACTIVATE Activate call barring 
TAPI SS CALL BAR DEACTIVATE De Activate call barring 


5.161.2.3 enum TelSsCallBarType t 


The various types of call barring. Note, only one type of incoming barring and only one type of outgoing 
barring may be active at any time. 


Enumerator: 


TAPI CALL BARRING ALL Barring all outgoing and incoming calls 
ТАРІ CALL BARRING OUTGOING Barring outgoing call 
TAPI CALL BARRING ALL OUTGOING CALLS Barring all outgoing calls 


TAPI CALL BARRING ALL OUTGOING INTERN CALL Barring all outgoing international 
calls 


TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT Barring аП interna- 
tional outgoing 


TAPI CALL BARRING INCOMING  Barring the incoming call 
TAPI CALL BARRING ALL INCOMING CALLS  Barring all incoming calls 


TAPI CALL BARRING ALL INCOMING CALLS ROAMING Barring all incoming calls 
while roaming 


ТАРІ CALL BARRING ALL INCOMING CALLS INSIM Barring Incoming Calls from num- 
bers which is not stored in the SIM memory 


5.161.2.4 enum TelSsCallType t 


This enumeration defines the call type . 


Enumerator: 


TAPI CALL TYPE VOICE EV Voice Call 
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TAPI CALL TYPE DATA EV Data Call 

ТАРІ CALL TYPE FAX EV Fax Call 

TAPI CALL TYPE SHORT MESS EV Short Message 

TAPI CALL TYPE DATA CIRCUIT SYNC EV Data Circuit Sync 


5.161.2.5 enum TelSsCause t 
Describes whether a supplementary service request was a success or a failure; and if it failed, why. 


Enumerator: 


TAPI SS SUCCESS SS operation was successful 

TAPI SS TIMEREXPIRE SS operation timer expired on network. 

TAPI SS UNKNOWNSUBSCRIBER SS error indicating unknown/illegal subscriber. 

TAPI SS SERVICENOTPROVISIONED SS service not provisioned 

TAPI SS CALLBARRED SS operation barred. 

TAPI SS ILLEGALSSOPERATION ERROR Illegal SS operation 

ТАРІ SS NOTAVAILABLE 55 not available in network 

TAPI SS SUBSCRIPTIONVIOLATION SS service subscription violation. 

TAPI SS FACILITYNOTSUPPORTED SS service facility not supported 

TAPI SS UNEXPECTEDDATAVALUE SS error indicating unexpected data value on network side 


TAPI SS PWREGISTRATIONFAILURE SS error indicating change password failure. 
ТАРІ SS NEGATIVEPWCHECK SS error indicating negative password check. 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION $$ error indicating barring password at- 
tempts violated. 


TAPI SS UNKNOWNALPHABET SS error indicating unknown SS data coding of alphabet 
TAPI SS USSDBUSY 55 error indicating USSD Busy(Already ss / ussd is ongoing). 
TAPI SS REJECTEDBYUSER SS operation rejected by user. 

TAPI SS REJECTEDBYNETWORK SS operation rejected by network. 


TAPI SS INVALIDDEFLECTEDTONUMBER SS error indicating the invalid deflected to num- 
ber. 


TAPI SS MAXNOMPTYEXCEEDED SS error indicating Maximum mpty is reached. 
TAPI SS RESOURCESNOTAVAILABLE SS error indicating resources not available in network. 
TAPI SS UNKNOWNERROR SS error indicating unknown error 


TAPI SS ОЕМ NOT SUPPORTED If oem do not support any of SS requests, then this error will 
be returned back 


5.161.2.6 enum TelSsCliStatus t 


This enumeration defines the cli service status . 


Enumerator: 


TAPI CLI STATUS NOT PROVISONED Service not provided by the service provider 
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TAPI CLI STATUS PROVISIONED Service is provided by the service provider 
TAPI CLI STATUS ACTIVATED Service is activated at the network 
TAPI CLI STATUS UNKOWN Service status is unknown 

TAPI CLI STATUS TEMP RESTRICTED Service is temporarily restricted 
TAPI CLI STATUS TEMP ALLOWED Service is temporarily allowed 


5.161.2.7 enum TelSsForwardMode t 


This enumeration defines the forward mode . 


Enumerator: 


TAPI CALL FORWARD MODE DISABLE EV  Deactivate call forwarding 
TAPI CALL FORWARD MODE ENABLE EV Activate call forwarding 

TAPI CALL FORWARD MODE REGISTRATION EV Register Call forwarding 
ТАРІ CALL FORWARD MODE ERASURE EV De-register call forwarding 


5.161.2.8 enum TelSsForwardType t 
This enumeration defines the forward type . 


Enumerator: 


TAPI CS FORWARD TYPE VOICE EV Voice call forward 
ТАРІ CS FORWARD TYPE DATA EV Data call forward 
TAPI CS FORWARD TYPE FAX EV Fax call forward 


5.161.2[:9 enum TelSsForwardWhen t 
/жж This enumeration defines the call forwarding flavor. 


Enumerator: 
TAPI SS FORWARD WHEN UNCONDITIONAL EV Unconditional 
TAPI SS FORWARD WHEN BUSY EV When Busy 
TAPI SS FORWARD WHEN NO ANSWER EV When No Reply 
TAPI SS FORWARD WHEN NOT REACHABLE EV When Not Reachable 
TAPI SS FORWARD WHEN ALL FORWARDING EV Forward All Calls 


5.161.2.10 enum TelSsLinelIdentificationType t 
These are the four types of identity presentation / restriction services. 


Enumerator: 


TAPI CALLING LINE IDENTITY PRESENTATION identify the party calling this phone 
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TAPI CALLING LINE IDENTITY RESTRICTION hide the identity of this phone when calling 
others 


TAPI CONNECTED LINE IDENTITY PRESENTATION identify the party to whom the call- 
ing party (this phone) is connected 


TAPI CONNECTED LINE IDENTITY RESTRICTION restrict yourself from being identified 
by incoming calls, such as forwarded calls 


TAPI CALLED LINE IDENTITY PRESENTATION Called line identity presentation 
TAPI CALLING NAME PRESENTATION Calling Name Presentation 


5.161.2.11 enum TelSsRestrictIDStatus t 
This enumeration defines the types of restrict identification . 


Enumerator: 
TAPI CALL RESTRICT ID DEPEND NETWORK EV Depend on Network 
TAPI CALL RESTRICT ID ENABLE EV Enable Restricted Call Id 
TAPI CALL RESTRICT ID DISABLE EV Disable Restricted Call Id 


5.161.2.12 enum TelSsStatus t 


The status of a supplementary service feature (e.g. Call Forwarding or Call Barring). 


These enumerated values should be used as masks 


Enumerator: 
TAPI SS STATUS ACTIVE Active Status 
TAPI SS STATUS REGISTERED SS Registered 
TAPI SS STATUS PROVISIONED Provision established 
TAPI SS STATUS QUIESCENT Provision established 
TAPI SS STATUS NOTHING Status Nothing 


5.161.2.13 enum TelSsTeleService t 


The types of telecommunication services are used for setting the statuses of supplementary services. They 
are typically not supported in IS-2000 or IS-136. See GSM 02.30 Annex C and GSM 22.030 Annex C. 


Enumerator: 
TAPI SS TS ALL TELE AND BEARER SERVICES АП Teleservices & Bearer Services 
TAPI SS TS ALL TELESERVICES АП Teleservices 
TAPI SS TS ALL SPEECH АП Speech Services 
TAPI SS TS ALL DATA TELESERVICES All Data Teleservices 
TAPI SS TS FACS АП Fax Service 
TAPI SS TS ALL TELESERVICES EXCEPT SMS All teleservice except SMS 
TAPI SS TS ALL PLMN SPEC TELE PLMN specific teleservices 
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TAPI SS TS PLMN SPEC 


TELE 1 


TAPI SS TS PLMN SPEC 


TELE 2 


TAPI SS TS PLMN SPEC 


TELE 3 


TAPI SS TS PLMN SPEC 


TELE 4 


TAPI SS TS PLMN SPEC 


TELE 5 


TAPI SS TS PLMN SPEC 


TELE 6 


TAPI SS TS PLMN SPEC 


TELE 7 


TAPI SS TS PLMN SPEC 


TELE 8 


TAPI SS TS PLMN SPEC 


TELE 9 


TAPI SS TS PLMN SPEC 


TELE A 


TAPI SS TS PLMN SPEC 


TELE B 


TAPI SS TS PLMN SPEC 


TELE C 


TAPI SS TS PLMN SPEC 


TELE D 


TAPI SS TS PLMN SPEC 


TELE E 


TAPI SS TS PLMN SPEC 


TELE F 


PLMN specific teleservice 1 
PLMN specific teleservice 2 
PLMN specific teleservice 3 
PLMN specific teleservice 4 
PLMN specific teleservice 5 
PLMN specific teleservice 6 
PLMN specific teleservice 7 
PLMN specific teleservice 8 
PLMN specific teleservice 9 
PLMN specific teleservice 10 
PLMN specific teleservice 11 
PLMN specific teleservice 12 
PLMN specific teleservice 13 
PLMN specific teleservice 14 
PLMN specific teleservice 15 


TAPI SS BS ALL BEARER SERVICES All PLMN specific bearer services 
ТАРІ SS BS ALL DATA CDS АП Data CDS 

TAPI SS BS ALL ASYNCHRONOUS АП Asynchronous 
ТАРІ SS BS ALL SYNCHRONOUS АП Synchronous 

TAPI SS BS DATA CIRCUIT SYNC All Data Circuit Synchronous 


TAPI SS BS DATA CIRCUIT ASYNC АП Data Circuit Asynchronous 


TAPI SS BS DATA ALL PDS All Data PDS 


TAPI SS BS ALL DATA PADCA 


TAPI SS BS ALL PLMN SPEC BS 


TAPI SS BS PLMN SPEC 


TELE 1 


TAPI SS BS PLMN SPEC 


TELE 2 


TAPI SS BS PLMN SPEC 


TELE 3 


TAPI SS BS PLMN SPEC 


TELE 4 


TAPI SS BS PLMN SPEC 


TELE 5 


TAPI SS BS PLMN SPEC 


TELE 6 


TAPI SS BS PLMN SPEC 


TELE 7 


TAPI SS BS PLMN SPEC 


TELE 8 


TAPI SS BS PLMN SPEC 


TELE 9 


TAPI SS BS PLMN SPEC 


TELE A 


TAPI SS BS PLMN SPEC 


TELE B 


TAPI SS BS PLMN SPEC 


TELE C 


TAPI SS BS PLMN SPEC 


TELE D 


TAPI SS BS PLMN SPEC 


TELE E 


TAPI SS BS PLMN SPEC 


TELE F 


TAPI SS TS ALL DATA 


АП Data 


АП Data PADCA 


All PLMN Spec BS 

PLMN specific bearer service 1 
PLMN specific bearer service 2 
PLMN specific bearer service 3 
PLMN specific bearer service 4 
PLMN specific bearer service 5 
PLMN specific bearer service 6 
PLMN specific bearer service 7 
PLMN specific bearer service 8 


PLMN specific bearer service 9 

PLMN specific bearer service 10 
PLMN specific bearer service 11 
PLMN specific bearer service 12 
PLMN specific bearer service 13 
PLMN specific bearer service 14 
PLMN specific bearer service 15 


TAPI SS TS DATA CIRCUIT SYNC Data Circuit Sync 
TAPI SS TS MULTIPLE multiple 
TAPI SS TS TELEPHONY Telephony 

TAPI SS TS DATA CIRCUIT ASYNC Data Circuit Async 
TAPI SS TS DATA PACKET Data packet 
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5.161.2.14 enum TelSsType t 
This enumeration type defines the Supplementary service types 


Enumerator: 


TAPI SS TYPE BARRING Barring SS 

TAPI SS TYPE FORWARDING Forward SS 

TAPI SS TYPE WAITING Waiting SS 

TAPI SS TYPE IDENTIFICATION Identification SS 
TAPI SS TYPE CNAP CNAPSS 

TYPE SS TYPE USSD Unstructured supplementary data SS 


5.161.2.15 enum TelSsUssdIndType t 
This enumeration defines the ussd Indication Type 


Enumerator: 


TAPI USSD IND NOTIFY notify : to display ussd data to user 

TAPI USSD IND NO ACTION REQUIRE No further user action required 

TAPI USSD IND ACTION REQUIRE Further user action required 

TAPI USSD IND TERMINATED BY NET 0x03 : USSD terminated by network 
TAPI USSD IND OTHER CLIENT 0x04 : other local client has responded 

TAPI USSD IND NOT SUPPORT 0x05 : operation not supported 

TAPI USSD IND TIME OUT 0x06: Time out when there is no response from network 


5.161.2.16 enum TelSsUssdRespType t 
This enumeration defines the ussd response type 


Enumerator: 
TAPI USSD RES UNKNOWN ALPHABET USSD data is unknown 
TAPI USSD RES DISPL BUSY USSD Data response is display busy 
TAPI USSD RES ОК USSD Data is encoded and properly propagated 
TAPI USSD RES NONE NO USSD Response from client 
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5.162 Utility Data Structures 


Files 


* file TelUtility.h 


This file serves as a "C" header file defines structures for Utility Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelTapiVersionInfo t 
* struct TelTapiTunnelInfo t 
e struct TelTapiErrorInfo t 


Enumerations 


* enum TapiResult t { 


TAPI API SUCCESS, TAPI API INVALID INPUT, TAPI API INVALID PTR, TAPI API - 
INVALID CALL STATE, 


TAPI API NOT SUPPORTED, TAPI API DEPRICATED, TAPI API SYSTEM OUT OF - 
MEM, ТАРІ АРІ SYSTEM КРС LINK. DOWN, 


TAPI API MODEM POWERED OFF, ТАРІ АРІ SERVICE NOT READY, ТАРІ АРІ - 
SERVER FAILURE, ТАРІ АРІ ОЕМ PLUGIN FAILURE, 


TAPI API INVALID CALL HANDLE, TAPI API INVALID DATA LEN, TAPI API SIM - 
NOT FOUND, TAPI API SIM BUSY, 


TAPI API SIM INVALID CARD TYPE, TAPI API SIM CARD PERMANENT ERROR, 
ТАРІ АРІ SIM. NOT INITIALIZED, ТАРІ АРІ REQUEST MAX IN PROGRESS, 


TAPI API OFFLINE MODE ERROR, TAPI EVENT CLASS UNKNOWN, TAPI EVENT - 
UNKNOWN, TAPI REGISTRATION FAILURE } 


5.162.1 Enumeration Type Documentation 
5.162.1.1 enum TapiResult_t 


Below enumerations are the return codes of TAPI API’s 


Enumerator: 


TAPI_API_ SUCCESS No Error occurred 

TAPI_API_INVALID_INPUT Input values are not correct in TAPI Library 
TAPI_API_INVALID_PTR Invalid pointer 
TAPI_API_INVALID_CALL_STATE request failed due to invalid call state 


TAPI API NOT SUPPORTED The feature corresponding to requested API is not supported. This 
may be due to market/network/vendor reasons such as the feature is not available in the network. 


TAPI API DEPRICATED This API is deprecated and will be so in future also 
TAPI API SYSTEM OUT OF MEM Out of memory 
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ТАРІ АРІ SYSTEM КРС LINK DOWN RPC link down 
TAPI API MODEM POWERED OFF The Modem is powered off 


TAPI API SERVICE NOT READY Phone was powered on, but yet to receive the power up com- 
pleted notification 


ТАРІ АРІ SERVER FAILURE error occurred in Telephony server 

TAPI API OEM PLUGIN FAILURE Plug-in layer failure 

TAPI API INVALID CALL HANDLE Invalid call handle 

TAPI API INVALID DATA LEN Invalid data length 

TAPI API SIM NOT FOUND Sim is not present / removed 

TAPI API SIM BUSY SIM is busy 

ТАРІ АРІ SIM INVALID CARD TYPE біп card is unknown 

TAPI API SIM CARD PERMANENT ERROR SIM error/blocked state 

TAPI API SIM NOT INITIALIZED SIM has not initialized yet (waiting for PIN verification, etc) 


TAPI API REQUEST MAX IN PROGRESS Maximum number of API Request for the same 
service are already in progress 


TAPI API OFFLINE MODE ERROR OEM Telephony Provider is in Offline mode. 
TAPI EVENT CLASS UNKNOWN Event class specified is not present in Event Class list. 
TAPI EVENT UNKNOWN Event specified is not present in TAPI Unsolicited Event list. 
TAPI REGISTRATION FAILURE Callback Registration/De-registration failed 
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Chapter 6 


Data Structure Documentation 


6.1 TelCallCugInfo t Struct Reference 


#include <TelCall.h> 


6.1.1 Detailed Description 


This data structure defines the CUG information. 


Data Fields 

* BOOL bCugFlag 

* unsigned int Index 

* TelCallCugOptions t Option 
6.1.2. Field Documentation 


6.1.21 BOOL TelCallCugInfo t::bCugFlag 


Closed User Group flag - it holds TRUE when it has data and FALSE otherwise. 


6.1.2.2 unsigned int TelCallCugInfo t::Index 


CUG Index value 


6.1.2.3 TelCallCugOptions t TelCallCugInfo t::Option 


Cug option type 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.2 TelCallEndInfo t Struct Reference 


#include <TelCall.h> 


6.2.1 Detailed Description 


This structure contains information about Call end informationl. 


Data Fields 


* TelCallCause t CallEndCause 
* unsigned int pCallHandle 

* unsigned int CallStartTime 

* unsigned int CallEndTime 


6.2.2 Field Documentation 
6.2.2.1 TelCallCause t TelCallEndInfo t::CallEndCause 


End cause for the call indicates whether the call is released normally or due to other cause 


6.2.2.2 unsigned int TelCallEndInfo t::pCallHandle 


Call handle 


6.2.2.3 unsigned int TelCallEndInfo t::CallStartTime 


Start time of the call(time in secs) 


6.2.2.4 unsigned int TelCallEndInfo t::CallEndTime 


End time of the call(time in secs) 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.3 TelCallIncomingCallInfo t Struct Reference 


#include <TelCall.h> 


6.3.1 Detailed Description 


This structure contains the incoming call information. 


Data Fields 


unsigned int CallHandle 

TelCallType t CallType 

TelSsLinelIdentificationType t CliPresentationIndicator 

char szCallingPartyNumber [ТАРІ CALL DIALDIGIT LEN MAX-«1] 

char szCallingPartySubAddress [ТАРІ САШ, SUBADDRESS LEN MAX-«1] 
TelCallingNamelInfo t CallingNameInfo 

TelCallUusInfo t UusInfo 

TelCallAlertingPattern t AlertingPattern 

TelCallRedirectionInfo t RedirectInfo 

int Signal 


6.3.2. Field Documentation 
6.3.2.1 unsigned int TelCallIncomingCallInfo t::CallHandle 


Handle for the call 


6.3.2.2 TelCallType t TelCallIncomingCallInfo_t::CallType 


Call type 


6.3.2.3  TelSsLineldentificationType t TelCallIncomingCallInfo t::CliPresentationIndicator 


Calling Party presentation indicator 


6.3.2.4 char TelCallIncomingCallInfo t::szCallingPartyNumber[TAPI CALL DIALDIGIT - 
LEN МАХ-11 


caller number,null terminated ASCII 


6.3.2.5 char TelCallIncomingCallInfo t::szCallingPartySubAddress|(TAPI CALL - 
SUBADDRESS LEN МАХ+1] 


called subaddress,null terminated ASCII 
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6.3.2.6 "TelCallingNamelnfo t TelCallIncomingCallInfo t::CallingNameInfo 


Call name info. If there is no information from network, this information will be NULL. 


6.3.2.7 TelCallUusInfo_t TelCallIncomingCallInfo t::UusInfo 


User -to User signaling information. (UUSI only is supported). If there is no information from network, 
this information will be NULL. 


6.3.2.8 TelCallAlertingPattern_t TelCallIncomingCallInfo t::AlertingPattern 


Alerting pattern 


6.3.2.9  TelCallRedirectionInfo t TelCallIncomingCallInfo t::RedirectInfo 


The data for the Call Redirect information. If there is no information from network, this information will 
be NULL. 


6.3.2.10 int TelCallIncomingCallInfo t::Signal 


Signal Value received from the network (ref: 3gpp spec). 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.4 TelCallingNamelInfo t Struct Reference 


#include <TelCall.h> 


6.4.1 Detailed Description 


This structure defines the calling name information 


Data Fields 


* TelCallNameMode_t NameMode 
е char szNameData [ТАРІ CALLING NAME SIZE MAX] 


6.4.2 Field Documentation 
6.4.2.1  TelCallNameMode t TelCallingNameInfo t::NameMode 


Display mode of the szNameData. 


6.4.2.2 char TelCallingNamelnfo t::szzNameData(TAPI CALLING NAME SIZE MAX] 


Calling party name string. 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.5 TelCallRedirectionInfo t Struct Reference 


#include <TelCall.h> 


6.5.1 Detailed Description 


This structure contains information about call redirection details. 


Data Fields 


• char szRedirectedNumber [ТАРІ CALL DIALDIGIT LEN МАХ+1] 
е char szRedirectSubAddress [ТАРІ САШ, SUBADDRESS. LEN МАХ+1] 


6.5.2 Field Documentation 


6.5.2.1 char TelCallRedirectionInfo_t::szRedirectedNumber[TAPL CALL DIALDIGIT LEN - 
МАХ+1] 


Redirected party number 


6.5.2.2 char TelCallRedirectionInfo t::szRedirectSubAddress|(TAPI CALL SUBADDRESS - 
LEN MAX-41] 


Redirect party sub-address 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.6 TelCallSetupParams t Struct Reference 


#include <TelCall.h> 


6.6.1 Detailed Description 


This structure contains information about an outgoing call. 


Data Fields 


TelCallType t CallType 

char szNumber [ТАРІ CALL. DIALDIGIT LEN МАХ+1] 

char szCalledPartySubAddress [ТАРІ САШ, SUBADDRESS LEN МАХ+1] 
TelCallIdentityMode t IdentityMode 

TelCallCugInfo t pCugInfo 

TelCallUusInfo, t pUusInfo 


6.6.2 Field Documentation 
6.6.2.1 TelCallType_t TelCallSetupParams t::CallType 


sets type of call (voice, data, video, emergency) 


6.6.2.2 char TelCallSetupParams t::szNumber[TAPI CALL DIALDIGIT LEN MAX-41] 


A string containing the destination phone number. This follows the dial number format. 


6.6.2.3 char TelCallSetupParams t::szCalledPartySubAddress|(TAPI CALL SUBADDRESS - 
LEN MAX41] 


A string containing the destination sub-address. This is Null terminated string. This is an optional param- 
eter and it can be NULL. 


6.6.2.4 TelCallIdentityMode t TelCallSetupParams t::IdentityMode 


Sets Calling Line Identity mode. If default value TAPI IDENTITY DEFAULT is set, OEM will set the 
default value. 


6.6.2.5 "TelCallCugInfo t TelCallSetupParams_t::pCugInfo 


Closed User Group Info (Closed User Group Info).This is an optional parameter and it can be NULL. 


6.6.2.6 TelCallUusInfo_t TelCallSetupParams t::pUusInfo 


User -to User signaling information. This is an optional parameter and it can be NULL. 


The documentation for this struct was generated from the following file: 
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* TelCall.h 
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6.7 TelCallStatus_t Struct Reference 


#include <TelCall.h> 


6.7.1 Detailed Description 


This structure contains information about call status. 


Data Fields 


* BOOL bMoCall 

* char pNumber [ТАРІ CALL. DIALDIGIT LEN MAX-«1] 
e TelCallType t CallType 

* TelCallActiveState t CallState 

* BOOL bConferenceState 


6.7.2 Field Documentation 
6.7.2. BOOL TelCallStatus t::bMoCall 


Status will be yes for MO Call. If MT call, then FALSE 


6.7.2.2 char TelCallStatus t::pNumber[TAPI CALL DIALDIGIT LEN МАХ+1] 


Mobile Number 


6.7.2.3  TelCallType t TelCallStatus t::CallType 


specifies type of call (voice, data, emergency) 


6.7.2.4 TelCallActiveState t TelCallStatus t::CallState 


Current Call state 


6.7.2.5 BOOL TelCallStatus t::bConferenceState 


Whether Call is in Conference or not 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.8 TelCallUserDatalInfo t Struct Reference 


#include <TelCall.h> 


6.8.1 Detailed Description 


This structure contains information about user data information. 


Data Fields 


* unsigned int CallHandle 
* TelCallUusInfo_t UusInfo 


6.8.2 Field Documentation 
6.8.2.1 unsigned int TelCallUserDataInfo_t::CallHandle 


Call Handle 


6.8.2.2 TelCallUusInfo_t TelCallUserDataInfo_t::UusInfo 


User-User Information(UUS1) received from the network 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.9 TelCallUusInfo t Struct Reference 


#include <TelCall.h> 


6.9.1 Detailed Description 


This structure defines the UUS information 


Data Fields 


* TelCallUusType t UusType 

* TelCallUusProtocolType t ProtocolType 

* BOOL bMoreDataPresent 

* unsigned short UusDataLen 

e unsigned char UusData [ТАРІ САШ, UUS. DATA LEN MAX] 


6.9.2 Field Documentation 
6.9.21 TelCallUusType_t TelCallUusInfo t::UusType 


User-User type defined as per 3GPP 24.008. 


6.9.2.2 TelCallUusProtocolType_t TelCallUusInfo t::ProtocolType 


User-User Protocol type defined as per 3GPP 24.008 


6.9.2.3 BOOL TelCallUusInfo_t::bMoreDataPresent 


Is more user-user information present 


6.9.2.4 unsigned short TelCallUusInfo t::UusDataLen 


User-user data length. 


6.9.2.5 unsigned char TelCallUusInfo t::UusData[(TAPI CALL UUS DATA LEN MAX] 


User-user data. 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.10 TelNetworkConfigSettings t Struct Reference 


#include <TelNetwork.h> 


6.10.1 Detailed Description 


This structure has information related to network startup. 


Data Fields 


* BOOL bAutoSelection 

* BOOL bPowerOnGprsAttach 

e unsigned int NoOfNwModePresent 

* TelNetworkMode_t NetworkOrder [TAPI_ NETWORK, ORDER, MAX] 
* TelNetworkServiceDomain t ServiceDomain 

* TelNetworkMode t NetworkMode 


6.10.2 Field Documentation 
6.10.2.1 BOOL TelNetworkConfigSettings t::bAutoSelection 


Determines whether the Auto selection mode is enabled or not 


6.10.2.2 BOOL TelNetworkConfigSettings_t::bPowerOnGprsAttach 


Determines whether the Power on with GPRS attach is enabled or not 


6.10.2.3 unsigned int TelNetworkConfigSettings t:: NoOfNwModePresent 


No of network mode provided in the network, order array list 


6.10.2.4 TelNetworkMode t TelNetworkConfigSettings t::NetworkOrder[TAPI NETWORK - 
ORDER MAX] 


This is array of TAPIL NETWORK, ORDER MAX size of TelNetworkMode t type 


6.10.2.5  TelNetworkServiceDomain t TelNetworkConfigSettings t::ServiceDomain 


This member sets the Service domain 


6.10.2.6 TelNetworkMode_t TelNetworkConfigSettings t::NetworkMode 


This member sets the Network mode 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.11  TelNetworkInfo t Struct Reference 


#include <TelNetwork.h> 


6.11.1 Detailed Description 


This structure has network information. 


Data Fields 


* TelNetworkServiceLevel t ServiceLevel 
• TelNetworkSystemId t SysId 

* BOOL bRoaming 

* BOOL bDisplaySpn 

* BOOL bDisplayRplmn 


6.11.2 Field Documentation 
6.11.2.1 TelNetworkServiceLevel t TelNetworkInfo t::ServiceLevel 


Service level available( Full Service or Limited service etc) 


6.11.2.2 TelNetworkSystemlId t TelNetworkInfo t::SysId 


System ID information 


6.11.2.3 BOOL TelNetworkInfo t::bRoaming 


Roaming PLMN or not 


6.11.2.4 BOOL TelNetworkInfo t::bDisplaySpn 


Service Provider Name should be displayed or not 


6.11.2.5 BOOL TelNetworkInfo t::bDisplayRplmn 


Display of Registered PLMN required or not. 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.12 TelNetworkList t Struct Reference 


#include <TelNetwork.h> 


6.12.1 Detailed Description 


This structure defines the network list. 


Data Fields 


* unsigned int NumOfNw Available 
• TelNetworkSystemlId t SystemList [ТАРІ NETWORK, LIST MAX] 


6.12.2 Field Documentation 
6.12.2.1 unsigned int TelNetworkList t:: NumOfNwAvailable 


Count for Network list 


6.12.2.2 TelNetworkSystemId t TelNetworkList t::SystemList|(TAPI NETWORK LIST MAX] 


List of Networks available 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.13 TelNetworkRadioInfo_t Struct Reference 


#include <TelNetwork.h> 


6.13.1 Detailed Description 


This structure defines the Radio information. 


Data Fields 


* unsigned short RxLevel 
* unsigned short RxQuality 
* unsigned short RssiBar 


6.13.2 Field Documentation 


6.13.2.1 unsigned short TelNetworkRadioInfo t::RxLevel 


Received radio signal level from the wireless stack.Radio signal strength indicator (RSSI) level.RSSI in 
positive dBm i.e. 75 means -75dBm.The valid range for AMPS:-110 to -89 dBm800 CDMA:-105 to -90 


dBm1900 CDMA: -108 to -93 dBm GSM/WCDMA: -105 to -60 dBm 


6.13.2.2 unsigned short TelNetworkRadioInfo t::RxQuality 


Radio signal quality received from the wireless stack. 


6.13.2.3 unsigned short TelNetworkRadiolInfo t::RssiBar 


Signal bars stating the signal strength 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.14 TelNetworkSystemld t Struct Reference 


Шіпсіпде <TelNetwork.h> 


6.14.1 Detailed Description 


This structure defines the network system information. 


Data Fields 


TelNetworkSystemType t SystemType 
TelNetworkServiceType t ServiceType 
TelNetworkSystemIdFormat. t SysIdFormat 
TelNetworkMode t NetworkMode 

unsigned long SysId 

BOOL bPImnForbidden 

BOOL bHome 

BOOL bEquivalentPlmn 

BOOL bNetworkldentityAvail 

BOOL bNetworkTimeAvail 

BOOL bNetworkTimeZoneAvail 

BOOL bNetworkDlsAvail 

char szSystemName [ТАРІ NETWORK NAME LEN MAX] 
char szSpn [TAPI NETWORK SPN LEN MAX] 
TelNetworkTimeAndZone t NetworkTimeZone 
BOOL bMncIncludesPesDigit 


6.14.2 Field Documentation 
6.14.2.1 TelNetworkSystemType t TelNetworkSystemId t::SystemType 


Network system technologies like GSM, CDMA, WCDMA, WLAN etc 


6.14.2.2 TelNetworkServiceType t TelNetworkSystemId_t::ServiceType 


Network service type - Cs, Ps or combined 


6.14.2.3 TelNetworkSystemIdFormat t TelNetworkSystemId t::SysIdFormat 


SID or PLMN based on system type 


6.14.2.4 TelNetworkMode t TelNetworkSystemId t::NetworkMode 


Network mode Information 


6.14.2.5 unsigned long TelNetworkSystemlId t::SysId 


PLMN Information 
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6.14.2.6 BOOL TelNetworkSystemId_t::bPlmnForbidden 


Forbidden PLMN or Not 


6.14.27 BOOL TelNetworkSystemId t::bHome 


Home PLMN Or not 


6.14.2. BOOL TelNetworkSystemlId t::bEquivalentPlmn 


Equivalent PLMN Or not 


6.14.2. BOOL TelNetworkSystemId_t::bNetworkIdentityAvail 


Network Identity Available or not 


6.14.2.10 BOOL TelNetworkSystemId t::bNetworkTimeAvail 


Network Time Available or not 


6.14.2.11 BOOL TelNetworkSystemId t::bNetworkTimeZoneAvail 


Network Timezone Available or not 


6.14.2.12 BOOL TelNetworkSystemId t::bNetworkDlsAvail 


Network DLS available or not 


6.14.2.13 char TelNetworkSystemlId t::szSystemName[TAPI NETWORK МАМЕ LEN MAX] 


PLMN Name or Network Name (Null terminated string) 


6.14.2.14 char TelNetworkSystemlId t::szSpn[TAPI NETWORK  SPN LEN MAX] 


Service Provider Name (Null Terminated string) 


6.14.2.15  TelNetworkTimeAndZone t TelNetworkSystemId_t::NetworkTimeZone 


If NetwotkTimezone present, then timezone value 


6.14.2.16 BOOL TelNetworkSystemId_t::bMncIncludesPcsDigit 


To determine whether PLMN is US PLMN or not 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.15 TelNetworkTimeAndZone t Struct Reference 


#include <TelNetwork.h> 


6.15.1 Detailed Description 


This structure defines the network time and zone information. 


Data Fields 


unsigned short Year 


unsigned short Month 


unsigned short Day 


unsigned short Hour 


unsigned short Minute 


unsigned short Second 


unsigned short TimeZone 
TelNetworkDayLightSavingAdj_t DaylightSave 


6.15.2 Field Documentation 
6.15.2.1 unsigned short TelNetworkTimeAndZone_t:: Year 


Year information 


6.15.2.2 unsigned short TelNetworkTimeAndZone_t::Month 


Month information 


6.15.2.3 unsigned short TelNetworkTimeAndZone_t::Day 


Day 


6.15.2.4 unsigned short TelNetworkTimeAndZone_t::Hour 


Hour 


6.15.2.5 unsigned short TelNetworkTimeAndZone_t::Minute 


Minute 


6.15.2.6 unsigned short TelNetworkTimeAndZone_t::Second 


Second 
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6.15.2.7 unsigned short TelNetworkTimeAndZone t::TimeZone 


Network time zone 


6.15.2.8  TelNetworkDayLightSavingAdj t TelNetworkTimeAndZone t::DaylightSave 


day light saving adjustment time 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.16 TelSimApnData t Struct Reference 


#include <TelSim.h> 


6.16.1 Detailed Description 


This structure defines the Access Point Name data 


Data Fields 


* unsigned long AclLen 
e unsigned short Acl [ТАРІ SIM. ACL MAX LEN] 


6.16.2 Field Documentation 
6.16.2.1 unsigned long TelSimApnData_t::AclLen 


Acess point name control list length. 


6.16.2.2 unsigned short TelSimApnData_t::Acl[TAPI_SIM_ACL_MAX LEN] 


Acl list 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.17 TelSimCallbackEvent_t Struct Reference 


#include <TelSim.h> 


6.17.1 Detailed Description 


This structure is used as a callback event notificaions in Telephony for applictions. 


Data Fields 


• int RequestId 

* int EventStatus 

* unsigned int DataLen 

e unsigned char ж pData 

* TelTapiEventType t EventType 


6.17.2 Field Documentation 
6.17.2.1 int TelSimCallbackEvent t::RequestId 


Handle to SIM -RequestId in LiMo 


6.17.2.2 int TelSimCallbackEvent t::EventStatus 


SIM event status - Operation result or Access result depending on API 


6.17.2.3 unsigned int TelSimCallbackEvent t::DataLen 


Data length 


6.17.2.4 unsigned char« TelSimCallbackEvent t::pData 


Data associated with the event 


6.17.2.5 TelTapiEventType t TelSimCallbackEvent t::EventType 


Event type 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.18 TelSimDeviceContext t Struct Reference 


#include <TelSim.h> 


6.18.1 Detailed Description 


This structure defines the SIM status data and SIM device context data 


Data Fields 


* TelSimStatusData_t SimStatusData 
* TelSimDeviceContextData_t SimDeviceCtxData 


6.18.2 Field Documentation 
6.18.2.1 TelSimStatusData t TelSimDeviceContext t::SimStatusData 


SIM data. 


6.18.2.2 TelSimDeviceContextData t TelSimDeviceContext t::SimDeviceCtxData 


SIM device context data. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.19 TelSimDeviceContextData t Struct Reference 


Шіпсіпде <TelSim.h> 


6.19.1 Detailed Description 


This structure defines the SIM device context data 


Data Fields 


BOOL blIsDeviceCtxdataValid 
BOOL bBdnEnable 

BOOL bFdnEnable 

BOOL bAclIEnable 

BOOL bImsilInvalidated 
unsigned long apnCount 


union { 
TelSimSstInfo. t SstInfo 
TelSimUstInfo. t UstInfo 
) SstData 


TelSimGroupldentifierInfo t GidlInfo 
TelSimGroupldentifierInfo t Gid2Info 
TelSimApnData t ApnData 


6.19.2 Field Documentation 
6.19.2.1 BOOL TelSimDeviceContextData_t::bIsDeviceCtxdata Valid 


Indicates if device conext (this) data is valid. 


6.19.22 BOOL TelSimDeviceContextData t::bBdnEnable 


BDN mode enabled or not. 


6.19.2.3 BOOL TelSimDeviceContextData t::bFdnEnable 


FDN mode enabled or not. 


6.19.2.4 BOOL TelSimDeviceContextData t::bAcIEnable 


ACL(Access Point Name Control List) enabled or not. 


6.19.2.5 BOOL TelSimDeviceContextData t::bImsilnvalidated 


IMSI Invalidated or not. 
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6.19.2.6 unsigned long TelSimDeviceContextData t::apnCount 


Number of Access point name. 


6.19.2.7 TelSimSstInfo t TelSimDeviceContextData t::SstInfo 


SIM Service table information. 


6.19.2.8 TelSimUstInfo t TelSimDeviceContextData t::UstInfo 


USIM Service table information. 


6.19.2.9 union { ... } TelSimDeviceContextData t::SstData 


SS data information 


6.19.2.10  TelSimGroupldentifierInfo t TelSimDeviceContextData t::GidlInfo 


Group Identifier 1. 


6.19.2.11  TelSimGroupldentifierInfo t TelSimDeviceContextData t::Gid2Info 


Group Identifier 2. 


6.19.2.12 TelSimApnData t TelSimDeviceContextData t::ApnData 


Access point data. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.20 TelSimEccData t Struct Reference 


#include <TelSim.h> 


6.20.1 Detailed Description 


This data structure defines the data for the Ecc information. 


Data Fields 


* TelUsimEccInfo_t UeccInfo [TAPI_SIM_UECC_RECORD_COUNT_MAX] 
е TelSimEccInfo_t EccInfo 


6.20.2 Field Documentation 


6.20.2.1 TelUsimEccInfo t TelSimEccData t::UeccInfo[TAPI SIM UECC RECORD COUNT - 
MAX] 


Usim Emergency Call Code information structure 


6.20.2.  TelSimEccInfo t TelSimEccData t::EccInfo 


Emergency Call Code information 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.21 TelSimEccInfo t Struct Reference 


#include <TelSim.h> 


6.21.1 Detailed Description 


This enumeration defines the Ecc information. 


Data Fields 


TAPI SIM ECC CODE LEN 
* char szEcc2 [TAPI SIM ECC CODE LEN 


• char szEccl | ] 
[ ] 
* char szEcc3 (TAPI SIM ECC CODE LEN] 
[ ] 
[ ] 


* char szEcc4 [TAPI SIM ECC CODE LEN 
* char szEcc5 [TAPI SIM ECC CODE LEN 


6.21.2 Field Documentation 


6.21.2.1 char TelSimEccInfo_t::szEcc1[TAPL SIM ECC CODE LEN] 


Emergency Call Code 1 info. ECC is coded in BCD format. Unused bytes is set to OxFF. 


6.21.2.2 char TelSimEccInfo t::szEcc2[|TAPI SIM ECC CODE LEN] 


Emergency Call Code 2 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.3 char TelSimEccInfo t::szEcc3[|TAPI SIM ECC CODE LEN] 


Emergency Call Code 3 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.4 char TelSimEccInfo t::szEccd[TAPI SIM ECC CODE LEN] 


Emergency Call Code 4 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.5 char TelSimEccInfo_t::szEcc5[TAPL SIM ECC CODE LEN] 


Emergency Call Code 5 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.22 TelSimEvent_t Struct Reference 


#include <TelSim.h> 


6.22.1 Detailed Description 


This structure is used as a callback event notifications for applications. 


Data Fields 


* int RequestId 

* int EventStatus 

* unsigned int DataLen 
e unsigned char ж pData 


6.22.2 Field Documentation 
6.22.2.1 int TelSimEvent t::RequestId 


RequestId 


6.22.2.2 int TelSimEvent t::EventStatus 


Sim Event Status 


6.22.2.3 unsigned int TelSimEvent t::DataLen 


Data length 


6.22.2.4 unsigned char« TelSimEvent t::pData 


Data associated with the event 


The documentation for this struct was generated from the following file: 


* TelSim.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


260 Data Structure Documentation 


6.23 TelSimFileAccessGeneralResp_t Struct Reference 


#include <TelSim.h> 


6.23.1 Detailed Description 


This data structure defines the response for SIM update file. 


Data Fields 


• TelSimFileID_t Fileld 
* TelSimAccessType_t AccessType 


6.23.2 Field Documentation 
6.23.2.1 TelSimFileID_t TelSimFileAccessGeneralResp t::FileId 


SIM file ID 


6.23.2.2 TelSimAccessType t TelSimFileAccessGeneralResp t::AccessType 


Access type 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.24 TelSimFileID t Struct Reference 


#include <TelSim.h> 


6.24.1 Detailed Description 


This structure contains information about File name and path. 


Data Fields 


* TelSimFileName t FileName 
* unsigned char szPath [128] 


6.24.2 Field Documentation 
6.24.2.1 TelSimFileName t TelSimFileID t::FileName 


Elementary FileName enumeration 


6.24.2.2 unsigned char TelSimFileID t::szPath[128] 


Absolute szPath of the elementary file. [Null Terminated] 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.25 TelSimFileInfo_t Struct Reference 


#include <TelSim.h> 


6.25.1 Detailed Description 


This structure defines the SIM device Elementary file information read 


Data Fields 


BOOL bValid 
TelSimFileID_t Fileld 
TelSimFileType_t FileType 
TelSimAcl_t AcRead 
TelSimAcl_t AcUpdate 
TelSimAcl_t AcInvalidate 
TelSimAcl_t AcRehabilitate 
unsigned long RecordLen 
unsigned long RecordCount 
unsigned long FileSize 


6.25.2 Field Documentation 
6.25.21 BOOL TelSimFileInfo_t::b Valid 


Valid or not 


6.25.2.2  TelSimFileID t TelSimFileInfo t::FileId 


File identifier 


6.25.2.3  TelSimFileType t TelSimFileInfo t::FileType 


File type and structure 


6.25.2.4 TelSimAcl t TelSimFileInfo t::AcRead 


Access condition for read operation 


6.25.2.5 TelSimAcl_t TelSimFileInfo t::AcUpdate 


Access condition for update operation 


6.25.2.6 TelSimAcl t TelSimFileInfo t::AcInvalidate 


Access condition for invalidate operation 
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6.25.27 TelSimAcl t TelSimFileInfo t::AcRehabilitate 


Access condition for rehabilitate operation 


6.25.2.8 unsigned long TelSimFileInfo t::RecordLen 


Length of one record in file 


6.25.2.9 unsigned long TelSimFileInfo t::RecordCount 


Number of records in file 


6.25.2.10 unsigned long TelSimFileInfo t::FileSize 


File size 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.26 TelSimGrouplIdentifierInfo t Struct Reference 


#include <TelSim.h> 


6.26.1 Detailed Description 


This data structure defines the data for the group identifier information. 


Data Fields 


e unsigned short GroupIdentifierLen 
e char szGroupldentifier [ТАРІ SIM GROUP IDENTIFIER LEN MAX] 


6.26.2 Field Documentation 
6.26.2.1 unsigned short TelSimGroupIdentifierInfo_t::GroupIdentifierLen 


Group identifier length 


6.26.2.2 char TelSimGroupldentifierInfo t::szGrouplIdentifier[TAPI SIM GROUP - 
IDENTIFIER LEN MAX] 


Group identifier 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.27 TelSimIccIdInfo t Struct Reference 


#include <TelSim.h> 


6.27.1 Detailed Description 


This data structure defines the data for the Iccid information. 


Data Fields 


* unsigned long IccidLength 
* unsigned short Iccid [TAPI_SIM_ICCIDLENGTH] 


6.27.2 Field Documentation 
6.27.2.1 unsigned long TelSimIccIdInfo t::IccidLength 


Integrated Circuit Card id length 


6.27.2.2 unsigned short TelSimIccIdInfo t::Iccid| TAPI SIM ICCIDLENGTH] 


Unique card identification number 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.28  TelSimImsilnfo t Struct Reference 


#include <TelSim.h> 


6.28.1 Detailed Description 


This data structure defines the data for the Imsi information. 


Data Fields 


* BOOL bValid 

e char szMcc [ТАРІ SIM MCC CODE LEN-«1] 
e char szMnc [ТАРІ SIM MNC CODE LEN-1] 
e char szMsin [ТАРІ SIM MSIN CODE LEN-«1] 


6.28.2 Field Documentation 
6.28.21 BOOL TelSimImsilnfo t::bValid 


Valid( ACTIVATE) IMSI (TRUE) or Deactivated (FALSE) 


6.28.2.2 char TelSimImsiInfo_t::szMcc[TAPI_SIM_MCC_CODE_LEN+1] 


mobile country code 


6.28.2.3 char TelSimImsilnfo t::szMnc[TAPI SIM MNC CODE LEN-1] 


mobile network code 


6.28.2.4 char TelSimImsilInfo t::szzMsin[|TAPI SIM MSIN CODE LEN-1] 


mobile station identification number 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.29 TelSimLanguageInfo t Struct Reference 
#include <TelSim.h> 


6.29.1 Detailed Description 


This data structure defines the data for the Language information. 


Data Fields 


* unsigned long LpCount 
• TelSimLangIndicationCode_t lp [ТАРІ SIM LI MAX LEN] 


6.29.2 Field Documentation 
6.29.2.1 unsigned long TelSimLanguageInfo t::LpCount 


Language preference count; zero indicates that the LP file is not available or it doesn't have any data. 


6.29.2.2  TelSimLanglIndicationCode t TelSimLanguagelnfo t::Ip|TAPI SIM LI MAX LEN] 


Language preference code 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.30 TelSimPb2gData t Struct Reference 


#include <TelSim.h> 


6.30.1 Detailed Description 


This data struture defines the 2G phone book data storage. 


Data Fields 


unsigned short NumLen 

unsigned short NumType 

unsigned short NameLen 

unsigned short NameEncryptType 

unsigned short Number [TAPI_SIM_NUM_TEXT_MAX_LEN] 
unsigned short Name [TAPI_SIM_NUM_TEXT_MAX_LEN] 


6.30.2 Field Documentation 
6.30.2.1 unsigned short TelSimPb2gData_t::NumLen 


Number length 


6.30.2.2 unsigned short TelSimPb2gData_t::NumType 


Number type [refer to TelSimTypeOfNum_t] 


6.30.2.3 unsigned short TelSimPb2gData t::NameLen 


Name string length 


6.30.2.4 unsigned short TelSimPb2gData_t::NameEncryptType 


Name string encryption type [refer to TelSimTextEncrypt_t] 


6.30.2.5 unsigned short TelSimPb2gData t::Number[TAPI SIM NUM TEXT MAX LEN] 


Number data 


6.30.2.6 unsigned short TelSimPb2gData t::Name[TAPI SIM NUM TEXT MAX LEN] 


Name string 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.31 TelSimPbEntryInfo_t Struct Reference 


#include <TelSim.h> 


6.31.1 Detailed Description 


This data structure gives the phone book entry information. 


Data Fields 


TelSimPbFileType_t StorageFileType 
unsigned short PbIndexMin 

unsigned short PbIndexMax 
unsigned short PbNumLenMax 
unsigned short PbTextLenMax 


6.31.2 Field Documentation 
6.31.2.1 TelSimPbFileType t TelSimPbEntryInfo_t::StorageFileType 


Storage file type 


6.31.2.2 unsigned short TelSimPbEntryInfo t::PbIndexMin 


Phone book minimum index 


6.31.2.3 unsigned short TelSimPbEntryInfo_t::PbIndexMax 


Phone book maximum index 


6.31.2.4 unsigned short TelSimPbEntryInfo_t::PbNumLenMax 


Phone number maximum length 


6.31.2.5 unsigned short TelSimPbEntryInfo_t::PbTextLenMax 


Text maximum length 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.32 TelSimPbReadResp_t Struct Reference 


#include <TelSim.h> 


6.32.1 Detailed Description 


This data structure gives the phone book read response information. 


Data Fields 


* TelSimPbAccessResult t PbAccessResult 
* TelSimPbRecordData t PbStorageData 


6.32.2 Field Documentation 
6.32.2.1 TelSimPbAccessResult_t TelSimPbReadResp t::PbAccessResult 


Indicates the result of phonebook update/read operation. 


6.32.2.2  TelSimPbRecordData t TelSimPbReadResp t::PbStorageData 


Data read from the phonebook file. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.33 TelSimPbRecordData t Struct Reference 


#include <TelSim.h> 


6.33.1 Detailed Description 


This structure defines the Phone book record data. 


Data Fields 


* TelSimPbFileType t StorageFileType 
* unsigned short Index 
* TelSimPb2gData t pPbData 


6.33.2 Field Documentation 
6.33.2.1 TelSimPbFileType t TelSimPbRecordData t::StorageFileType 


Storage file type 


6.33.2.2 unsigned short TelSimPbRecordData t::Index 


Index of the record being read/updated. 


6.33.2.3 TelSimPb2gData t TelSimPbRecordData t::pPbData 


Phone book contact info. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.34 TelSimPbStorageInfo_t Struct Reference 


#include <TelSim.h> 


6.34.1 Detailed Description 


This data structure defines the phone book storage count information. 


Data Fields 


* TelSimPbFileType t StorageFileType 
* unsigned short TotalRecordCount 
* unsigned short UsedRecordCount 


6.34.2 Field Documentation 
6.34.2.1 TelSimPbFileType t TelSimPbStoragelInfo t::StorageFileType 


Storage file type 


6.34.2.2 unsigned short TelSimPbStoragelInfo t::TotalRecordCount 


Total record count 


6.34.2.3 unsigned short TelSimPbStorageInfo t::UsedRecordCount 


Used record count 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.35 TelSimPbUpdateResp_t Struct Reference 


#include <TelSim.h> 


6.35.1 Detailed Description 


This data structure gives the phone book update(add/edit/delete) response. 


Data Fields 


* TelSimPbAccessResult t PbAccessResult 
• TelSimPbStorageInfo t PbStorageInfo 
* unsigned short PbIndex 


6.35.2 Field Documentation 
6.35.2.1  TelSimPbAccessResult t TelSimPbUpdateResp t::PbAccessResult 


Indicates the result of phonebook update/read operation. 


6.35.2.2  TelSimPbStorageInfo t TelSimPbUpdateResp t::PbStorageInfo 


Indicates the total and used phonebook entries for the updated storage type (ADN/FDN, etc). 


6.35.2.3 unsigned short TelSimPbUpdateResp t::PbIndex 


Phone book record index that was updated/deleted. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.36 TelSimPinData t Struct Reference 


#include <TelSim.h> 


6.36.1 Detailed Description 


This structure contains information about pin data. 


Data Fields 


* TelSimPinType t PinType 
e char szPinCode [ТАРІ SIM PIN LENGTH- 1] 


6.36.2 Field Documentation 
6.36.2.1  TelSimPinType t TelSimPinData t::PinType 


Pin type 


6.36.2.2 char TelSimPinData t::szPinCode[|TAPI SIM PIN LENGTH-1] 


PIN code 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.37 TelSimPinInfo_t Struct Reference 


#include <TelSim.h> 


6.37.1 Detailed Description 


This data structure defines the data for the PIN Informtion. 


Data Fields 


* TelSimPinType t PinType 
* int RemainingAttempts 


6.37.2 Field Documentation 
6.37.2.1 TelSimPinType t TelSimPinInfo t::PinType 


Specifies the PIN or PUK type. 


6.37.2.2 int TelSimPinInfo t::RemainingAttempts 


Number of attempts remaining for PIN/PUK verification. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.38 TelSimReadFileData_t Struct Reference 


Шіпсіпде <TelSim.h> 


6.38.1 Detailed Description 


This structure contains all read SIM elementary file information. 


Data Fields 


• TelSimHileID t Fileld 
* unsigned short DataLen 
* unsigned char Data 


6.38.2 Field Documentation 
6.38.2.1 TelSimFileID t TelSimReadFileData t::FileId 


File Id 


6.38.2.2 unsigned short TelSimReadFileData t::DataLen 


Data Length 


6.38.2.3 unsigned char TelSimReadFileData t::Data 


SIM EF Data 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.39 TelSimReadFileRequestData_t Struct Reference 


#include <TelSim.h> 


6.39.1 Detailed Description 


This data structure defines the data for the Read file result information. 


Data Fields 


TelSimFileID_t FileID 
TelSimFileType_t FileType 
unsigned long Offset 


unsigned long RecordIndex 


unsigned long RecordIndexFrom 


unsigned long RecordIndexTo 
TelSimRecordMode_t RecordMode 
unsigned long DataLength 


6.39.2 Field Documentation 
6.39.2.1 TelSimFileID_t TelSimReadFileRequestData_t::FileID 


sim file id to read 


6.39.2.2 TelSimFileType_t TelSimReadFileRequestData_t::FileType 


sim file type 


6.39.2.3 unsigned long TelSimReadFileRequestData_t::Offset 


Offset if read binary 


6.39.2.4 unsigned long TelSimReadFileRequestData_t::RecordIndex 


record index if read record 


6.39.2.5 unsigned long TelSimReadFileRequestData_t::RecordIndexFrom 


start index from 


6.39.2.6 unsigned long TelSimReadFileRequestData_t::RecordIndexTo 


end index to 
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6.39.2.7 TelSimRecordMode t TelSimReadFileRequestData t::RecordMode 


record mode if read record 


6.39.2.8 unsigned long TelSimReadFileRequestData t::DataLength 


data length to read 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.40 TelSimServiceTable t Struct Reference 


#include <TelSim.h> 


6.40.1 Detailed Description 


This data structure defines the data for the Sst (SIM service table) information. 


Data Fields 


BOOL bPIN1DisableFunction 
BOOL bAdn 

BOOL bFdn 

BOOL bSms 

BOOL bAoc 

BOOL bCcp 

BOOL bPlmnSelector 

BOOL bRful 

BOOL bMsisdn 

BOOL bExtensionl 

BOOL bExtension2 

BOOL bSmsParams 

BOOL bind 

BOOL bCellBroadCastMsglId 
BOOL bGroupldLevell 

BOOL bGroupIdLevel2 

BOOL bSpn 

BOOL bSdn 

BOOL bExtension3 

BOOL bRfu2 

BOOL bVgcsGroupIdList 

BOOL bVbsGroupIDList 

BOOL bEnhancedMultilevelPrecedencePreemptionService 
BOOL bAutoAnswerForeMLPP 
BOOL bSmsCbdDataDownload 
BOOL bSmsPpDataDownload 
BOOL bMenuSelection 

BOOL bCallControl 

BOOL bProactiveSimCommand 
BOOL bCellBroadcastMsgIdRanges 
BOOL bBdn 

BOOL bExtension4 

BOOL bDePersonalizedControlKeys 
BOOL bCoOperativeNetworkList 
BOOL bSmsr 

BOOL bNetworkAlertIndInMS 
BOOL bMoSMSControl 

BOOL bGPRS 

BOOL bImage 
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BOOL bSolsa 

BOOL bUSSDSupportedInCallControl 

BOOL bRunAtCommand 

BOOL bUserControlledPLMNSelectorAccessTech 
BOOL bOperatorControlledPlmnSelectorAccessTech 
BOOL bHpImnSelectorAccessTech 

BOOL bCPBCCHInfo 

BOOL biInvestigationScan 

BOOL bExtenedCapaConfigParams 

BOOL bMexe 

BOOL bRplmnLastUsedAccessTech 


6.40.2 Field Documentation 
6.40.2.1 BOOL TelSimServiceTable_t::bPIN1DisableFunction 


PIN1 disable function 


6.40.2.2 BOOL TelSimServiceTable_t::bAdn 


abbreviated Dialing number 


6.40.23 BOOL TelSimServiceTable_t::bFdn 


fixed Dialing number 


6.40.2.4 BOOL TelSimServiceTable_t::bSms 


short message storage 


6.40.2.5 BOOL TelSimServiceTable_t::bAoc 


advice of charge 


6.40.2.6 BOOL TelSimServiceTable_t::bCcp 


capability configuration parameters 


6.40.27 BOOL TelSimServiceTable_t::bPlmnSelector 


plmn selector 


6.40.2.8 BOOL TelSimServiceTable_t::bRful 


rfu 
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6.40.2.9 BOOL TelSimServiceTable t::bMsisdn 


msisdn 


6.40.2.10 BOOL TelSimServiceTable_t::bExtension1 


extension | 


6.40.2.11 BOOL TelSimServiceTable_t::bExtension2 


extension2 


6.40.2.12 BOOL TelSimServiceTable_t::bSmsParams 


sms paramteres 


6.40.2.13 BOOL TelSimServiceTable_t::blnd 


last number dialled 


6.40.2.14 BOOL TelSimServiceTable_t::bCellBroadCastMsgId 


cell broadcast message identifier 


6.40.2.15 BOOL TelSimServiceTable_t::bGroupIdLevel1 


group identifier level 1 


6.40.2.16 BOOL TelSimServiceTable t::bGroupIdLevel2 


group identifier level 2 


6.40.2.17 BOOL TelSimServiceTable_t::bSpn 


service provider name 


6.40.2.18 BOOL TelSimServiceTable_t::bSdn 


service Dialing number 


6.40.2.19 BOOL TelSimServiceTable_t::bExtension3 


extension3 
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6.40.2.20 BOOL TelSimServiceTable t::bRfu2 


rfu 


6.40.2.21 BOOL TelSimServiceTable t::bVgcsGrouplIdList 


vgcs group identifier (EF-VGCS, EF-VGCSS) 


6.40.2.22 BOOL TelSimServiceTable t::bVbsGroupIDList 


vbs group identifier (EF-VBS, EF-VBSS) 


6.40.2.23 BOOL TelSimServiceTable t::bEnhancedMultilevelPrecedencePreemptionService 


enhanced multi-level precedence and pre-emption service 


6.40.2.24 BOOL TelSimServiceTable t::bAutoAnswerForeMLPP 


automatic answer fro eMLPP 


6.40.2.25 BOOL TelSimServiceTable t::bSmsCbdDataDownload 


data download via sms-cb 


6.40.2.26 BOOL TelSimServiceTable t::bSmsPpDataDownload 


data download via sms-pp 


6.40.2.27 BOOL TelSimServiceTable_t::bMenuSelection 


menu selection 


6.40.2.28 BOOL TelSimServiceTable t::bCallControl 


call control 


6.40.2.29 BOOL TelSimServiceTable t::bProactiveSimCommand 


proactive sim command 


6.40.2.30 BOOL TelSimServiceTable_t::bCellBroadcastMsgIdRanges 


cell broadcast message identifier ranges 
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6.40.2.31 BOOL TelSimServiceTable t::bBdn 


barred Dialing numbers 


6.40.2.32 BOOL TelSimServiceTable t::bExtension4 


extension 4 


6.40.2.33 BOOL TelSimServiceTable_t::bDePersonalizedControlKeys 


de-personalization control keys 


6.40.2.34 BOOL TelSimServiceTable_t::bCoOperativeNetworkList 


co-operative network list 


6.40.2.35 BOOL TelSimServiceTable_t::bSmsr 


short message status reports 


6.40.2.36 BOOL TelSimServiceTable_t::bNetworkAlertIndInMS 


network’s indication of alerting in the MS 


6.40.2.37 BOOL TelSimServiceTable_t::bMoSMSControl 


mobile-originated short message control by sim 


6.40.2.38 BOOL TelSimServiceTable t::bGPRS 


gprs 


6.40.2.39 BOOL TelSimServiceTable_t::bImage 


image 


6.40.2.40 BOOL TelSimServiceTable_t::bSolsa 


support of local service area 


6.40.2.41 BOOL TelSimServiceTable t::bUSSDSupportedInCallControl 


ussd string data object supported in call control 
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6.40.2.42 BOOL TelSimServiceTable t::bRunAtCommand 


RUN AT COMMAND command 


6.40.2.43 BOOL TelSimServiceTable_t::bUserControlledPLMNSelectorAccessTech 


user controlled PLMN selector with Access technology 


6.40.2.44 BOOL TelSimServiceTable t::bOperatorControlledPImnSelectorAccessTech 


operator controlled PLMN selector with Access technology 


6.40.2.45 BOOL TelSimServiceTable t::bHplmnSelectorAccessTech 


HPLMN selector with access technology 


6.40.2.46 BOOL TelSimServiceTable t::bCPBCCHInfo 


CPBCCH information 


6.40.2.47 BOOL TelSimServiceTable t::bInvestigationScan 


investigation scan 


6.40.2.48 BOOL TelSimServiceTable t::bExtenedCapaConfigParams 


extended capability configuration parameters 


6.40.2.49 BOOL TelSimServiceTable t::bMexe 


MExE 


6.40.2.50 BOOL TelSimServiceTable t::bRplmnLastUsedA ccess Tech 


RPLMN last used access technology 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.41 TelSimSstInfo_t Struct Reference 


#include <TelSim.h> 


6.41.1 Detailed Description 


This data structure defines the data for the Sim service table information. 


Data Fields 


* unsigned long SstLen 
* unsigned short SstData [TAPI SIM SST MAX LEN] 
* TelSimServiceTable t Sst 


6.41.2 Field Documentation 
6.41.2.1 unsigned long TelSimSstInfo t::SstLen 


SIM service table length 


6.41.2.2 unsigned short TelSimSstInfo t::SstData[TAPI SIM SST MAX LEN] 


SIM service table data 


6.41.2.3 TelSimServiceTable t TelSimSstInfo t::Sst 


This data structure defines the data for the Sst (SIM service table) information. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.42  TelSimStatusData t Struct Reference 


Шіпсіпде <TelSim.h> 


6.42.1 Detailed Description 


This data structure defines the SIM card status data. 


Data Fields 


TelSimCardStatus_t CardStatus 

TelSimPinStatus_t UpinStatus 

TelSimPinStatus_t Pin1 Status 

TelSimPinStatus_t Pin2Status 

TelSimCardType_t CardType 

unsigned short EccRecordCount 

TelSimEccData_t EccRecord 
TelSimLanguageInfo t LpInfo 

unsigned long IccidLen 

unsigned short Iccid [TAPI SIM ICCIDLENGTH] 


6.42.2 Field Documentation 
6.42.2.1 TelSimCardStatus t TelSimStatusData_t::CardStatus 


Provides the card status 


6.42.2.2 TelSimPinStatus t TelSimStatusData t::UpinStatus 


Universal PIN status 


6.42.2.3 TelSimPinStatus t TelSimStatusData_t::Pin1Status 


Provides the Pin 1 status 


6.42.2.4 TelSimPinStatus t TelSimStatusData t::Pin2Status 


Provides the Pin 2 status 


6.42.2.5 TelSimCardType t TelSimStatusData t::CardType 


Provides the SIM card type 


6.42.2.6 unsigned short TelSimStatusData t::EccRecordCount 


Provides the Emergency Call Code record count 
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6.42.27 TelSimEccData_t TelSimStatusData t::EccRecord 


Provides the Emergency call codes 


6.42.2.8  TelSimLanguagelnfo t TelSimStatusData t::LpInfo 


Provides the Language preference information 


6.42.2.9 unsigned long TelSimStatusData t::IccidLen 


Provides the Integrated Circuit Card id length 


6.42.2.10 | unsigned short TelSimStatusData t::Iccid|(TAPI SIM ICCIDLENGTH] 


Provides the Integrated Circuit Card id 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.43 TelSimUpdateFileRequestData t Struct Reference 


#include <TelSim.h> 


6.43.1 Detailed Description 


This structure contains the information required to update elementary files in SIM. 


Data Fields 


TelSimFileID t FileId 
TelSimFileType t FileType 


unsigned long Offset 


unsigned long RecordIndex 
TelSimRecordMode t RecordMode 


unsigned long DataLen 


unsigned char ж szData 


6.43.2 Field Documentation 
6.43.2.1 TelSimFileID t TelSimUpdateFileRequestData_t::FileId 


sim file id to update 


6.43.2.2  TelSimFileType t TelSimUpdateFileRequestData t::FileType 


sim file type 


6.43.2.3 unsigned long TelSimUpdateFileRequestData t::Offset 


Offset, if update for a binary file 


6.43.2.4 unsigned long TelSimUpdateFileRequestData t::RecordIndex 


Record index, if update is for record type file 


6.43.2.5  TelSimRecordMode t TelSimUpdateFileRequestData t::RecordMode 


Record index, if update is for record type file 


6.43.2.6 unsigned long TelSimUpdateFileRequestData t::DataLen 


szData length to update 
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6.43.2.7 unsigned char» TelSimUpdateFileRequestData t::szData 


SIM EF Data 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.44 TelSimUstInfo_t Struct Reference 


#include <TelSim.h> 


6.44.1 Detailed Description 


This data structure defines the data for the USim service table information. 


Data Fields 


* unsigned long UsimSstLen 
* unsigned short UstData [TAPI SIM SST MAX LEN] 
* TelUSimServiceTable t UsimSst 


6.44.2 Field Documentation 
6.44.2.1 unsigned long TelSimUstInfo t::UsimSstLen 


USIM service table length 


6.44.2.2 unsigned short TelSimUstInfo t::UstData|(TAPI SIM SST MAX LEN] 


USIM service table data - Complete service table from sim. 


6.44.2.3 TelUSimServiceTable t TelSimUstInfo t::UsimSst 


This data structure defines the data for the UST (USIM service table) information. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.45 TelSmsAddressInfo t Struct Reference 


#include <TelNetText.h> 


6.45.1 Detailed Description 


This structure defines the properties of a dialing number Type of Number, Numbering Plan Indicator, length 
and the actual number. 


Data Fields 


* unsigned int DialNumLen 

* TelSimTypeOfNum t Ton 

• TelSimNumberingPlanlIdentity t Npi 

e unsigned char szDiallingNum [ТАРІ SIM. SMSP ADDRESS LEN-«1] 


6.45.2 Field Documentation 
6.45.2.1 unsigned int TelSmsAddressInfo_t::DialNumLen 


length of address 


6.45.2.2 TelSimTypeOfNum t TelSmsAddressInfo_t::Ton 


Type of number 


6.45.2.3 TelSimNumberingPlanIdentity t TelSmsAddressInfo_t::Npi 


Numbering plan identification 


6.45.2.4 unsigned char Tel8msA ddressInfo t::szDiallingNum[TAPI SIM SMSP ADDRESS - 
LEN+1] 


destination address 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.46 TelSmsCbConfig t Struct Reference 


#include <TelNetText.h> 


6.46.1 Detailed Description 


This structure defines the different parameters of CB configuration 


Data Fields 


* BOOL bCBEnabled 

* unsigned char SelectedId 

• int MsgIdCount 

e unsigned short MsgIDs [ТАРІ NETTEXT GSM. SMS CBMI LIST SIZE MAX] 


6.46.2 Field Documentation 
6.46.21 BOOL TelSmsCbConfig_t::bCBEnabled 
CB service state. If cb enabled is true then cell broadcast service will be enabled and underlying modem 


will enable CB Channel to receiving CB messages. Otherwise CB service will be disabled, underlying 
modem will deactivate the CB channel. (enabled/disabled) 


6.46.2.2 unsigned char TelSmsCbConfig_t::SelectedId 


CBMI Identifier selected (all or some) 


6.46.2.3 int TelSmsCbConfig_t::MsgIdCount 


CB message ID count 


6.46.2.4 unsigned short TelSmsCbConfig_t::MsgIDs[TAPI NETTEXT_GSM_SMS_CBMI_- 
LIST SIZE MAX] 


CB message ID information 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.47 TelSmsCbMsg t Struct Reference 


#include <TelNetText.h> 


6.47.1 Detailed Description 


This structure defines a cell broadcast message. 


Data Fields 


e TelSmsCbMsgType_t CbMsgType 
* unsigned short Length 
e char szMsgData [ТАРІ NETTEXT CB PAGE SIZE MAX+1] 


6.47.2 Field Documentation 
6.47.21  Tel8msCbMsgType t Tel8msCbMsg t:: CbMsgType 


Cell Broadcast message type 


6.47.2.2 unsigned short Tel8msCbMsg t::Length 


Size of array szMsgData (which is actual TPDU message) 


6.47.2.3 char Tel$msCbMsg t::szMsgData[TAPI NETTEXT CB PAGE SIZE МАХ+1] 


Cell broadcast message data[Refer 3GPP TS 23.041 9.4.1] 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.48 TelSmsData t Struct Reference 


#include <TelNetText.h> 


6.48.1 Detailed Description 


This structure defines the data Related to SimIndex,MessageStatus and SMS Data Stored. 


Data Fields 


* signed short SimIndex 
* TelSmsMsgStatus_t MsgStatus 
* TelSmsDatapackageInfo_t SmsData 


6.48.2 Field Documentation 
6.48.2.1 signed short TelSmsData_t::SimIndex 


Index where SMS is stored. If index is invalid (-1), then it means the message is not stored in SIM. 


6.48.2.2 Tel$8msMsgStatus t TelSmsData_t::MsgStatus 


Message status. If index is invalid, Msg status shall be ignored. 


6.48.2.3 TelSmsDatapackageInfo_t TelSmsData_t::SmsData 


SMS message 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.49 TelSmsDatapackageInfo t Struct Reference 


#include <TelNetText.h> 


6.49.1 Detailed Description 


This structure defines the fields related to an Sms like sim index, TPDU and length 


Data Fields 
e char ж pSCA 
* int MsgLength 
e char szData [ТАРІ NETTEXT SMDATA SIZE МАХ-11 
6.49.2 Field Documentation 
6.49.2.1 char» TelSmsDatapackagelInfo_t::pSCA 
Service Centre address - an optional parameter. If this parameter is not present, then this field will be Null.If 


present, the valid service centre address information is filled as per TelSmsAddressInfo_t and provided as 
char 


6.49.2.2 int TelSmsDatapackageInfo_t::MsgLength 


Size of array szData (which is actual TPDU message) 


6.49.2.3 char TelSmsDatapackageInfo_t::szData[TAPI_NETTEXT_SMDATA_SIZE_MAX+1] 


SMS TPDU message 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.50 TelSmsParams t Struct Reference 


#include <TelNetText.h> 


6.50.1 Detailed Description 


This structure defines different fields involved in setting the parameters of a particular sms in EFsmsp. 


Data Fields 


unsigned char RecordIndex 


unsigned char RecordLen 


unsigned long AlphaldLen 

char szAlphald [ТАРІ SIM. SMSP ALPHA ID LEN MAX-«1] 
BYTE ParamIndicator 

TelSmsAddressInfo t TpDestAddr 

TelSmsAddressInfo t TpSvcCntrAddr 

unsigned short TpProtocolId 


unsigned short TpDataCodingScheme 


unsigned short Tp ValidityPeriod 


6.50.2 Field Documentation 
6.50.2.1 unsigned char TelSmsParams_t::RecordIndex 


Index 


6.50.2.2 unsigned char TelSmsParams_t::RecordLen 


SMS Parameter Record length 


6.50.2.3 unsigned long Tel8msParams t::AlphaldLen 


Alpha id length 


6.50.2.4 char Tel$msParams t::szAlphald[TAPI SIM SMSP ALPHA ID LEN МАХ-11 


Alpha id .It is a unique identifier for each row/record in EFsmsp 


6.50.2.5 BYTE TelSmsParams_t::ParamIndicator 


SMS parameter indicator is a 1 byte value. Each bit in this value indicates the presence/absence of the 
sms header parameters.If the parameter is present the corresponding bit value is set to O.If the parameter is 
absent then it is set as 1.Refer 3GPP TS 31.02 :4.4.23 
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6.50.2.6 TelSmsAddressInfo_t TelSmsParams_t::TpDestAddr 


TP-destination address (TP-DA) 


6.50.2.7 TelSmsAddressInfo_t TelSmsParams_t::TpSvcCntrAddr 


TP-service center address 


6.50.2.8 unsigned short TelSmsParams_t::TpProtocolld 


TP-protocol Id 


6.50.2.9 unsigned short TelSmsParams_t::TpDataCodingScheme 


TP-data coding scheme 


6.50.2.10 unsigned short TelSmsParams_t::TpValidityPeriod 


TP-validity period 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.51 TelSmsStoredMsgCountInfo t Struct Reference 


#include <TelNetText.h> 


6.51.1 Detailed Description 


This structure defines the different parameters that are related to the message count in a particular mem- 
ory(Phone/SIM) 


Data Fields 


* unsigned int TotalCount 
* int UsedCount 
* int IndexList [TAPI МЕТТЕХТ (55М SMS MSG NUM MAX] 


6.51.2 Field Documentation 
6.51.2.1 unsigned int TelSmsStoredMsgCountInfo_t::TotalCount 


Total count of messages stored in SIM 


6.51.2.2 int Tel8msStoredMsgCountInfo t::UsedCount 


Stored message count in SIM in SIM 


6.51.2.3 int Tel8msStoredMsgCountInfo t::IndexList[TAPI NETTEXT GSM SMS MSG - 
NUM MAX] 


Message index list stored in SIM. And the maximum size of this array can be of totalCount.This array 
contains the list of index values in which the messages are stored.i.e. index list[totalcount] = [2,3] denotes 
that indexs 2 and 3 are stored(valid) and others not(empty). 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.52 TelSsCallBarringInfo_t Struct Reference 


#include <TelSs.h> 


6.52.1 Detailed Description 


This structure defines the different parameters related to call barring. 


Data Fields 


* TelSsCallBarOperationMode t Mode 

* TelSsCallBarType t Type 

* TelSsCallType t CallType 

* char szPassword [TAPI 55 GSM BARR PW LEN MAX] 


6.52.2 Field Documentation 
6.52.21  TelSsCallBarOperationMode t TelSsCallBarringInfo t::Mode 


Barring mode 


6.52.2.2 TelSsCallBarType t TelSsCallBarringInfo t::Type 


Barring type 


6.52.2.3 TelSsCallType_t TelSsCallBarringInfo_t::CallType 


Call type 


6.52.2.4 char TelSsCallBarringInfo_t::szPassword[TAPI_SS_GSM_BARR_PW_LEN_MAX] 


password 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.53 TelSsCallBarringRecord_t Struct Reference 


#include <TelSs.h> 


6.53.1 Detailed Description 


This structure defines the values for ss call barring record 


Data Fields 


* TelSsStatus t Status 
* TelSsCallBarType t Flavour 
* TelSsTeleService t TeleCommService 


6.53.2 Field Documentation 
6.53.2.1 'TelSsStatus t TelSsCallBarringRecord t::Status 


Ss status 


6.53.2.2 TelSsCallBarType t TelSsCallBarringRecord t::Flavour 


Call barring types providing various barring conditions on that basis call be barred 


6.53.2.3  TelSsTeleService t TelSsCallBarringRecord t::TeleCommService 


Tele service 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.54 TelSsCallWaitingRecord t Struct Reference 


#include <TelSs.h> 


6.54.1 Detailed Description 


This structure defines the values for ss call waiting record 


Data Fields 


* TelSsStatus t Status 
* TelSsTeleService t TeleCommService 


6.54.2 Field Documentation 
6.54.2.1 TelSsStatus_t TelSsCallWaitingRecord_t::Status 


SS status 


6.54.2.2 TelSsTeleService t TelSsCall WaitingRecord_t::TeleCommService 


Tele service 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.55 TelSsCapabilityInfo_t Struct Reference 


#include <TelSs.h> 


6.55.1 Detailed Description 


This structure defines the various parameters in a capability info type 


Data Fields 


* BOOL bCFSupported 

* BOOL bCBSupported 

* BOOL bMPTYSupported 

* BOOL bCWSupported 

* BOOL bCallHoldSupported 
* BOOL bECTSupported 


6.55.2 Field Documentation 
6.55.21 BOOL TelSsCapabilityInfo t::bCFSupported 


TRUE will indicate call forwarding supported, FALSE otherwise. 


6.55.2.2 BOOL TelSsCapabilityInfo t::bCBSupported 


TRUE will indicate call barring supported, FALSE otherwise. 


6.55.2.3 BOOL TelSsCapabilityInfo t::bMPTYSupported 


TRUE will indicate Multi Party call handling supported, FALSE otherwise 


6.55.2.4 BOOL TelSsCapabilityInfo t::bCWSupported 


TRUE will indicate call waiting supported, FALSE otherwise 


6.55.25 BOOL TelSsCapabilityInfo t::bCallHoldSupported 


TRUE will indicate call hold supported, FALSE otherwise. 


6.55.2.6 BOOL TelSsCapabilityInfo t::bECTSupported 


TRUE will indicate explicit call transfer supported, FALSE otherwise. 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.56 TelSsCliRecord t Struct Reference 


#include <TelSs.h> 


6.56.1 Detailed Description 


This structure defines the values for Calling line identity service 


Data Fields 


* TelSsLineldentificationType_t IdentificationType 
* TelSsCliStatus_t CliStatus 


6.56.2 Field Documentation 
6.56.2.1 'TelSsLineIdentificationType t TelSsCliRecord t::IdentificationType 


Various line identification types 


6.56.2.2 TelSsCliStatus t TelSsCliRecord t::CliStatus 


Line indentification status from network 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.57 TelSsForwardInfo_t Struct Reference 


#include <TelSs.h> 


6.57.1 Detailed Description 


This structure defines the different parameters related to forward info. 


Data Fields 


* TelSsForwardMode t Mode 

* TelSsForwardType t Type 

* TelSsForwardWhen t Condition 

• char szPhoneNumber [ТАРІ CALL DIALDIGIT LEN MAX] 


6.57.2 Field Documentation 
6.57.21  TelSsForwardMode t TelSsForwardInfo t::Mode 


Forward Mode 


6.57.2.2  TelSsForwardType t TelSsForwardInfo t::Type 


Forward Type 


6.57.2.3 TelSsForwardWhen t TelSsForwardInfo_t::Condition 


Forward Condition 


6.57.2.4 char TelSsForwardInfo t::szPhoneNumber(TAPI CALL DIALDIGIT LEN MAX] 


Phone Number 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.58 TelSsForwardRecord t Struct Reference 


#include <TelSs.h> 


6.58.1 Detailed Description 


This structure defines the values for ss call forwarding record 


Data Fields 


* TelSsStatus t Status 

* TelSsForwardWhen t ForwardCondition 

* TelSsTeleService t TeleCommService 

* BOOL bCallForwardingNumberPresent 

* unsigned char szCallForwardingNumber [ТАРІ САШ, DIALDIGIT LEN MAX] 


6.58.2 Field Documentation 
6.58.2.1  TelSsStatus t TelSsForwardRecord t::Status 


Call forwarding SS status 


6.58.2.2 TelSsForwardWhen t TelSsForwardRecord t::ForwardCondition 


Call forward types providing various conditions when call can be forwarded 


6.58.2.3  TelSsTeleService t TelSsForwardRecord t::TeleCommService 


Tele service type 


6.58.2.4 BOOL TelSsForwardRecord t::bCallForwardingNumberPresent 


Call forwarding number present or not 


6.58.2.5 unsigned char TelSsForwardRecord t::szCallForwardingNumber[TAPI CALL - 
DIALDIGIT LEN MAX] 


forwarded number.[Null Terminated string] 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.59 TelSsInfo_t Struct Reference 


#include <TelSs.h> 


6.59.1 Detailed Description 


related all kind of SS information 


Data Fields 


* TelSsType t SsType 

* TelSsStatus t SsStatus 

* UINT NumberOfRecords 

* TelSsRecord t SsRecord 

* TelSsTeleService t SsTeleserviceType 


6.59.2 Field Documentation 
6.59.2.1  TelSsType t TelSsInfo t::SsType 


Supplementary service type 


6.59.2.2 TelSsStatus t TelSsInfo t::SsStatus 


SS status information 


6.59.2.3 ОМТ TelSsInfo_t::NumberOfRecords 


Number of records present for Call Barring / Call forwarding / Call waiting. In case of any error, this 


parameter value will be set to zero. 


6.59.2.4  TelSsRecord t TelSsInfo t::SsRecord 


SS record (Union of Call Barring / Call Forwarding/Call waiting / line identification information). This 


structure can be Null when number. of records parameter is zero. 


6.59.2.5 "TelSsTeleService t TelSsInfo t::SsTeleserviceType 


Tele service type 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.60 TelSsRecord t Union Reference 


#include <TelSs.h> 


6.60.1 Detailed Description 


This structure defines the parameters for SS record type 


Data Fields 


* TelSsCallWaitingRecord_t WaitingRecord 
* TelSsCallBarringRecord t BarringRecord 
* TelSsCliRecord t CliRecord 

* TelSsForwardRecord t ForwardingRecord 


6.60.2 Field Documentation 
6.60.2.1 TelSsCallWaitingRecord_t TelSsRecord_t::WaitingRecord 


Call waiting information 


6.60.2.2 TelSsCallBarringRecord t TelSsRecord t::BarringRecord 


Call barring information 


6.60.2.3 TelSsCliRecord_t TelSsRecord t::CliRecord 


Line identification information 


6.60.2.4 TelSsForwardRecord_t TelSsRecord t::ForwardingRecord 


Call forward record information 


The documentation for this union was generated from the following file: 


* TelSs.h 
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6.61 TelSsUssdMsgInfo_t Struct Reference 


#include <TelSs.h> 


6.61.1 Detailed Description 


This structure defines the values for USSD request type. 


Data Fields 


* TelSsUssdIndType t IndType 

e UINTS8 Dcs 

* int UssdStringLength 

* char szUssdString [TAPI SS USSD DATA SIZE MAX] 


6.61.2 Field Documentation 
6.61.2.1  TelSsUssdIndType t TelSsUssdMsgInfo t::Ind Type 


USSD Indication type (This field is used in case of sending USSD Response only) 


6.61.2.2 UINTS TelSsUssdMsglInfo t::Dcs 


Data coding scheme value as per 3GPP TS 23.038 


6.61.2.3 int TelSsUssdMsgInfo t::UssdStringLength 


USSD data length 


6.61.2.4 char TelSsUssdMsglInfo t::szUssdString[ TAPI SS USSD DATA SIZE MAX] 


USSD data 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.62 TelTapiErrorInfo_t Struct Reference 


#include «TelUtility.h» 


6.62.1 Detailed Description 


This structure holds information like length and actual error data. 


Data Fields 


* unsigned int Length 
e void x pErrorData 


6.62.2 Field Documentation 
6.62.2.1 unsigned int TelTapiErrorInfo_t::Length 


Length of error data 


6.62.2.2 void» TelTapiErrorInfo t::pErrorData 


Error information exchanged between OEM and application(Not Null terminated string). For Debug- 
ging/Display purpose on screen. 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.63 TelTapiTunnelInfo_t Struct Reference 


#include «TelUtility.h» 


6.63.1 Detailed Description 


This structure holds information like length and actual tunneling data. 


Data Fields 


* unsigned int TunnelDataLen 
e void x pTunnelData 


6.63.2 Field Documentation 
6.63.2.1 unsigned int TelTapiTunnelInfo t::TunnelDataLen 


Length of tunnel data 


6.63.2.2 void» TelTapiTunnelInfo t::pTunnelData 


Tunneling information exchanged between OEM and application(Not Null terminated string) 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.64 TelTapiVersionInfo_t Struct Reference 


#include «TelUtility.h» 


6.64.1 Detailed Description 


This structure holds Telephony version information. 


Data Fields 


e int Major Version 
* int MinorVersion 


6.64.2 Field Documentation 
6.64.2.1 int TelTapiVersionInfo_t::MajorVersion 


Major Telephony version 


6.64.2.2 int TelTapiVersionInfo_t::MinorVersion 


Minor Telephony version 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.65 TelUsimEccInfo t Struct Reference 


#include <TelSim.h> 


6.65.1 Detailed Description 


This data structure defines the data for the USim emergency call code information. 


Data Fields 


* BOOL bUsed 

* char szEcc [TAPI SIM ECC CODE LEN] 

* unsigned short EccLen 

* char szEccAlphaldentifier [TAPI SIM ECC ALPHA STRING LEN MAX] 
• TelSimEccEmergencyServiceInfo t EccEmergencyServiceInfo 


6.65.2 Field Documentation 
6.65.2.1 BOOL TelUsimEccInfo t::bUsed 


Userd or not 


6.65.2.2 char TelUsimEccInfo t::szEcc[TAPI SIM ECC CODE LEN] 


Emergency Call Code info-ECC is coded in BCD format. Unused bytes is set to OxFF. 


6.65.2.3 unsigned short TelUsimEccInfo t::EccLen 


Ecc length 


6.65.2.4 char TelUsimEccInfo t::szEccAlphaldentifier[TAPI SIM ECC ALPHA STRING - 
LEN MAX] 


Alphabet identifer 


6.65.2.5 TelSimEccEmergencyServiceInfo t TelUsimEccInfo t::EccEmergencyServiceInfo 


ECC emergency service information 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.66 TelUSimServiceTable t Struct Reference 


#include <TelSim.h> 


6.66.1 Detailed Description 


This data structure defines the data for the UST (USIM service table) information. 


Data Fields 


BOOL bLocalPhoneBook 

BOOL bFdn 

BOOL bExtension2 

BOOL bSdn 

BOOL bExtension3 

BOOL bBdn 

BOOL bExtension4 

BOOL bOCIOCT 

BOOL blcilct 

BOOL bSms 

BOOL bSmsr 

BOOL bSMSP 

BOOL bAoc 

BOOL bCcp 

BOOL bCellBroadcastMsgId 
BOOL bCellBroadcastMsgIdRanges 
BOOL bGroupldLevell 

BOOL bGroupIdLevel2 

BOOL bSpn 

BOOL bUserControlledPLMNSelectorAccessTech 
BOOL bMsisdn 

BOOL bImage 

BOOL bSolsa 

BOOL bEnhancedMultilevelPrecedencePreemptionService 
BOOL bAutoAnswerForeMLPP 
BOOL bRful 

BOOL bGsmAccess 

BOOL bSmsPpDataDownload 
BOOL bSmsCbdDataDownload 
BOOL bUsimCallControl 

BOOL bUsimMoSmsControl 
BOOL bRunAtCommand 

BOOL bShallBeSetToOne 

BOOL bEnabledServiceTable 
BOOL bAcl 

BOOL bDePersonalizedControlKeys 
BOOL bCoOperativeNetworkList 
BOOL bGsmSecurityContext 
BOOL bCpbcchiInformation 
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BOOL blInvestigationScan 
BOOL bMexe 


BOOL bOperatorControlledPlmnSelectorAccessTech 


BOOL bHpImnSelectorAccessTech 
BOOL bExtension5 

BOOL bPlmnNetworkName 

BOOL bOperatorPlmnList 

BOOL bMailBoxDiallingNumbers 
BOOL bMsgWaitingIndStatus 

BOOL bCallForwardingIndicationStatus 
BOOL bRplmnLastUsedAccessTech 
BOOL bServiceProviderDisplayInfo 
BOOL bMms 

BOOL bExtension8 

BOOL bUsimGpsCallControl 

BOOL bMmsUserConnectivityParameters 
BOOL bNia 

BOOL bVgcslIdList 

BOOL bVbsGrouplId 


6.66.2 Field Documentation 


6.66.2.1 BOOL TelUSimServiceTable 6: 


local phone book 


6.66.2.2 BOOL TelUSimServiceTable_t::bFdn 


fixed Dialing number 


6.66.2.3 BOOL TelUSimServiceTable_t:: 


extension 2 


6.66.2.4 BOOL TelUSimServiceTable_t::bSdn 


service Dialing number 


6.66.2.5 BOOL TelUSimServiceTable_t:: 


extension 3 


6.66.2.6 BOOL TelUSimServiceTable_t:: 


barred Dialing numbers 


bLocalPhoneBook 


bExtension2 


bExtension3 


bBdn 
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6.66.2.7 BOOL TelUSimServiceTable_t::bExtension4 


extension 4 


6.66.2.8 BOOL TelUSimServiceTable t::bOCIOCT 


outgoing call information 


6.66.2.9 BOOL TelUSimServiceTable t::bIcilct 


incoming call information 


6.66.2.10 BOOL TelUSimServiceTable_t::bSms 


short message storage 


6.66.2.11 BOOL TelUSimServiceTable_t::bSmsr 


short message status reports 


6.66.2.12 BOOL TelUSimServiceTable_t::bSMSP 


short message service parameters 


6.66.2.13 BOOL TelUSimServiceTable_t::bAoc 


advice of charage 


6.66.2.14 BOOL TelUSimServiceTable_t::bCcp 


capability config parameters 


6.66.2.15 BOOL TelUSimServiceTable t::bCellBroadcastMsglId 


cell broadcast message identifier 


6.66.2.16 BOOL TelUSimServiceTable_t::bCellBroadcastMsgIdRanges 


cell broadcast message identifier randges 


6.66.2.17 BOOL TelUSimServiceTable_t::bGroupIdLevel1 


group identifier level 1 
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6.66.2.18 BOOL TelUSimServiceTable_t::bGroupIdLevel2 


group identifier level 2 


6.66.2.19 BOOL TelUSimServiceTable_t::bSpn 


service provide name 


6.66.2.20 BOOL TelUSimServiceTable_t::bUserControlledPLMNSelectorAccessTech 


user controlled plmn selector with access technology 


6.66.2.21 BOOL TelUSimServiceTable_t::bMsisdn 


msisdn 


6.66.2.22 BOOL TelUSimServiceTable_t::bImage 


image 


6.66.2.23 BOOL TelUSimServiceTable_t::bSolsa 


Solsa 


6.66.2.24 BOOL TelUSimServiceTable_t::bEnhancedMultilevelPrecedencePreemptionService 


enhanced multi-level precedence and pre-emption service 


6.66.2.25 BOOL TelUSimServiceTable_t::bAutoAnswerForeMLPP 


automatic answer fro eMLPP 


6.66.2.26 BOOL TelUSimServiceTable_t::bRful 


Rful 


6.66.2.27 BOOL TelUSimServiceTable_t::bGsmAccess 


gsm access 


6.66.2.28 BOOL TelUSimServiceTable_t::bSmsPpDataDownload 


data download via sms-pp 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.66 TelUSimServiceTable t Struct Reference 


317 


6.66.2.29 BOOL TelUSimServiceTable t::bSmsCbdDataDownload 


data download via sms-cb 


6.66.2.30 BOOL TelUSimServiceTable t::bUsimCallControl 


usim call control 


6.66.2.31 BOOL TelUSimServiceTable t::bUsimMoSmsControl 


mo-sms control by usim 


6.66.2.32 BOOL TelUSimServiceTable t::bRunAtCommand 


RUN AT COMMAND command 


6.66.2.33 BOOL TelUSimServiceTable_t::bShallBeSetToOne 


shall be set to 1 


6.66.2.34 BOOL TelUSimServiceTable t::bEnabledServiceTable 


enabled service table 


6.66.2.35 BOOL TelUSimServiceTable t::bAcl 


APN control list 


6.66.2.36 BOOL TelUSimServiceTable t::bDePersonalizedControlKeys 


de-personalization control keys 


6.66.2.37 BOOL TelUSimServiceTable_t::bCoOperativeNetworkList 


co-operative network list 


6.66.2.38 BOOL TelUSimServiceTable t::bGsmSecurityContext 


gsm security context 


6.66.2.39 BOOL TelUSimServiceTable t::bCpbcchilnformation 


cpbcch information 
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6.66.2.40 BOOL TelUSimServiceTable t::bInvestigationScan 


investigation scan 


6.66.2.41 BOOL TelUSimServiceTable t::bMexe 


mexe 


6.66.2.42 BOOL TelUSimServiceTable t::bOperatorControlledPImnSelectorAccessTech 


Operator controlled PLMN selector with Access Technology 


6.66.2.43 BOOL TelUSimServiceTable_t::bHplmnSelectorAccessTech 


HPLMN selector with access technology 


6.66.2.44 BOOL TelUSimServiceTable_t::bExtension5 


extension 5 


6.66.2.45 BOOL TelUSimServiceTable_t::bPlmnNetworkName 


plmn network name 


6.66.2.46 BOOL TelUSimServiceTable t::bOperatorPImnL ist 


operator plmn list 


6.66.2.47 BOOL TelUSimServiceTable t::bMailBoxDiallingNumbers 


mailbox Dialing numbers 


6.66.2.48 BOOL TelUSimServiceTable t::bMsgWaitingIndStatus 


message waiting indication status 


6.66.2.49 BOOL TelUSimServiceTable_t::bCallForwardingIndicationStatus 


call forwarding indication status 


6.66.2.50 BOOL TelUSimServiceTable t::bRplmnLastUsedAccessTech 


RPLMN last used access technology 
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6.66.2.51 BOOL TelUSimServiceTable t::bServiceProviderDisplayInfo 


service provider display information 


6.66.2.52 BOOL TelUSimServiceTable t::bMms 


multimedia messaging service 


6.66.2.53 BOOL TelUSimServiceTable t::bExtension8 


extension 8 


6.66.2.54 BOOL TelUSimServiceTable_t::bUsimGpsCallControl 


call control on gprs by usim 


6.66.2.55 BOOL TelUSimServiceTable_t::bMmsUserConnectivityParameters 


mms user connectivity parameters 


6.66.2.56 BOOL TelUSimServiceTable_t::bNia 


Network’s indication of alerting in the MS (NIA) 


6.66.2.57 BOOL TelUSimServiceTable t::bVgcsIdList 


VGCS Group Identifier List (EFVGCS and EFVGCSS) 


6.66.2.58 BOOL TelUSimServiceTable_t::bVbsGroupId 


VBS Group Identifier List (EFVBS and EFVBSS) 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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Chapter 7 


File Documentation 


7.1 ComponentOverview.h File Reference 


7.1.4 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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7.22 OemTapiCall.h File Reference 


7.2.1 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI Call Module. 
Note: Call related Supplementary services are dependent on Operator/Market/Vendor.If any of call related 


supplementary service is not supported in underlying telephony provider due to dependencies, then SS 
APIs 


may return an error ТАРІ АРІ NOT SUPPORTED from OEM Adaptation layer. 


#include "TapiCommon.h" 


#include "TapiContext.h" 


#include "ITapiCall.h" 


Functions 


• TapiResult t TelOemCallSetupReq (const TelCallSetupParams t *pParams) 


This function requests to originate the MO call. 


TapiResult t TelOemCallAnswerReq (int CallId, TelCallAnswerType t AnsType) 


This function answers the incoming call (either accept or reject the incoming call). 


TapiResult t TelOemCallReleaseReq (int CallId) 


This function releases call identified by callid, (active, held, waiting). 


TapiResult t TelOemCallSendDtmfReq (char *pDtmfString) 
This function sends DTMF strings during the call. 


TapiResult t TelOemCallRetrieveReq (int CallId) 
This function retrieves the held call. The call identified by the call handle must be in held state. 


TapiResult t TelOemCallHoldReq (int CallId) 


This function puts the given call on hold. The call identified by call identifier must be in active state. 


TapiResult t TelOemCallJoinReq (int ActiveCallId, int HeldCallId) 


This function joins the active call and the held call into a conference mode. Either of the call handle 
(Active/held) will become an MPTY-call-id and the other will join the conference. 


TapiResult t TelOemCallSplitReq (int CallId) 


This function splits a private call from multiparty call. 


TapiResult t TelOemCallTransferReq (int CallId) 


This function invokes the explicit call transfer. On successful execution, the active and held call identifiers 
will no longer be valid. 


BOOL TelOemCallSendDtmfCnf (TelCallCause t Cause) 
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This function is called to send a response for sending DTMF tones confirmation in a call. 


* BOOL TelOemCallSetupCnf (int CallId, TelCallCause t Cause) 
This function is called to indicate that Call Setup is being requested at the OEM Telephony provider. 


• BOOL TelOemCallReleaseCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send an asynchronous response for the call-release request. 


* BOOL TelOemCallAnswerCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send an asynchronous response for the call-answer request. 


* BOOL TelOemCallHoldCnf (int CallId, TelCallCause t Cause) 


This function is called to send an asynchronous response for the hold request. 


* BOOL TelOemCallRetrieveCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response for the retrieve request. 


• BOOL TelOemCallJoinCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response from Oem to telephony server regarding the acceptance of the 
call join request. 


e BOOL TelOemCallSplitCnf (int CallId, TelCallCause t Cause) 


This function is invoked to send a response for split call request from conference. 


e BOOL TelOemCallTransferCnf (int CallId, TelCallCause t Cause) 


TThis function is called to send a response for the explicit transfer request. 


e BOOL TelOemCallIncomingInd (int CallId, const TelCallIncomingCallInfo t «pIncomCallInfo) 


This function is called to send the incoming call indication to an Application. 


• BOOL TelOemCallAlertInd (int CallId) 


This function is invoked to send alert indication from the lower layers. 


* BOOL TelOemCallConnectedInd (int CallId) 


This function is invoked to send a connected indication from the lower layers. 


e BOOL TelOemCallConnectingInd (int CallId) 


This function is invoked to send a connecting indication from the lower layers. 


* BOOL TelOemCallEndInd (int CallId, TelCallCause_t Cause) 


This function is invoked to send the call end indication triggered by the user or from the network or by the 
modem due to low coverage or some other reasons. 


* BOOL TelOemCallForwardInd (int CallId) 


This function is called to provide the remote call forwarding indication received at OEM. 


• BOOL TelOemCallRetrieveInd (int CallId) 


This function sends an indication that the remote party has been retrieved its held call. 


• BOOL TelOemCallHoldInd (int CallId) 
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ThThis function is invoked to send remote side call hold indication. 


BOOL TelOemCallTransferInd (int CallId) 


This function is invoked to send an indication related with the remote party explicit call transfer. 


BOOL TelOemCallJoinInd (int CallId) 


This function is invoked to send an indication when a call is joined in the conference call.(multiparty call). 


BOOL TelOemCall WaitingInd (int CallId) 


This function is called to provide the remote call forwarding indication received at OEM. 


BOOL TelOemCallUserInfoInd (int CallId, const TelCallUusInfo_t *ptr uus, info) 


This function is invoked to send an indication related with the user-to-user(UUSI) information received 
from network during call establishment procedures and call end based on 3GPP 24.008 TS. 


void tapi oem call set incoming line (unsigned char line) 

void tapi oem, call set current call number (unsigned char CallId) 

BOOL tapi oem call on hold released ind (int CallId, TelCallCause t Cause) 
BOOL tapi oem call alert remote ect ind (int CallId, TelCallCause_t Cause) 
BOOL tapi oem call connected remote ect ind (int CallId, TelCallCause t Cause) 
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7.3 OemTapiCommon.h File Reference 


7.3.1 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI Common and Tunnel Module. 


#include "TapiCommon.h" 


#include "limo defines.h" 


Enumerations 


* enum TelOemPhoneStatus t { 


OEM INIT COMPLETED, ОЕМ INIT FAILED, ОЕМ DEINIT COMPLETED, OEM - 
DEINIT FAILED, 


OEM PHONE RESET IND } 


Functions 


* TapiResult t TelOemInitReq (void) 


This function shall be called during Telephony Server initialization when started. As OEM Adaptation layer 
is a plug-in, Initialization of OEM Adaptation layer plug-in should be handled in this API functionality. 
This initialization function is vendor specific implementation. 


* TapiResult t TelOemDelnitReq (void) 


This function shall be called during Telephony Server de-initialization procedure. As OEM Adaptation layer 
is a plug-in, De-Initialization of OEM Adaptation layer plug-in should be handled in this API functionality. 
This De-initialization function is vendor specific implementation. 


BOOL TelOemInitCnf (TelOemPhoneStatus_t PhoneStatus) 


This function is used to send the confirmation of the Oem Init request to the upper layers. 


BOOL TelOemDelnitCnf (TelOemPhonesStatus t PhoneStatus) 


This function is used to send the confirmation of the Oem De-Init request to the upper layers. 


BOOL TelOemPhoneStatusInd (TelOemPhoneStatus t PhoneStatus) 


This function is used to indicate the OEM phone reset indication to the Telphony Server. This indication 
should be sent by OEM Adaptation layer after reset has completed and OEM Telephony Provider is ready 
to receive further requests. 


• TapiResult t TelOemTunnelReq (const TelTapiTunnelInfo t *pTunnelInfo, int RequestId) 


This function is used to transfer vendor specific data transparently to the OEM. This API can be used for 
vendor specific procedures. 


BOOL TelOemTunnelCnf (const TelTapiTunnelInfo t *pTunnelInfo, int RequestId) 


This function is used to provide confirmation for Tunnel request API. This API is used to transfer vendor 
specific data transparently. 


BOOL TelOemTunnelInd (const TelTapiTunnelInfo_t TunnelInfo) 
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This function is used to indicate the unsolicited Tunnelling information transparently. 
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7.4 OemTapiNetText.h File Reference 


7.4.1 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI Network Text Module. 


#include "ITapiNetText.h" 


Functions 


е TapiResult t TelOemSmsSendReq (const TelSmsDatapackageInfo t *pDataPackage, BOOL b- 
MoreMsgToSend, int RequestId) 


This function sends an SMS message to OEM provider in order to transmit to Network. 


• TapiResult t TelOemSmsReadReq (int Index, int RequestId) 


This function reads a message from SIM card for provided index.It uses index number to identify the message. 


e TapiResult_t TelOemSmsWriteReq (TelSmsMessageStatus_t MsgStatus, const TelSms- 
DatapackageInfo_t *pDataPackage, int RequestId) 


This function writes/saves a message to SIM storage area. 


e TapiResult_t TelOemSmsDeleteReq (int Index, int RequestId) 


This function is used to delete the SMS for the provided index(sim index where the SMS record is stored). 


* TapiResult t TelOemSmsSetSCAReq (const TelSmsAddressInfo_t *pSCAddr) 


This function is used to set SMS Service Centre Address information. 


* TapiResult t TelOemSmsGetCountReq (int RequestId) 


This function is used to retrieve message count and the list from Sim storage. 


* TapiResult t TelOemSmsCBGetConfigReq (int RequestId) 


This function is used to retrieve SMS CB configuration options. 


e TapiResult t TelOemSmsCBSetConfigReq (const TelSmsCbConfig_t *pCBConfig, int RequestId) 
This function is used to set SMS CB configuration. 


e TapiResult t TelOemSmsGetPreferredBearerReq (int RequestId) 


This function requests the preferred bearer from TS. 


* TapiResult t TelOemSmsSetPreferredBearerReq (TelSmsBearerType_t SmsBearer, int RequestId) 


This function sets the preferred bearer on which SMS has to be transmitted. 


е TapiResult г TelOemSmsSendDeliveryReportReq (const TelS$msDatapackageInfo t — «pData- 
Package, int RequestId) 


This function sets the delivery report for received incoming SMS to the network. 


е TapiResult t TelOemSmsSetParametersReq (const TelSmsParams t *pSmsParam, int RequestId) 


This function is used to set the parameters for the SMS. 
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TapiResult t TelOemSmsGetParametersReq (int Index, int RequestId) 


This function is used to get the required parameters for SMS by passing the index. 


BOOL TelOemSmsSendCnf (const TelSmsDatapackageInfo_t «pDataPackage, TelSmsResponse t 
SmsResponse, int RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


BOOL TelOemSmsReadCnf (const TelSmsData_t *pReadData, TelSmsCause_t SmsCause, int 
RequestId) 


This function used to send the SMS message which is stored in the SIM to the application. 


BOOL TelOemSmsCBGetConfigCnf (const TelSmsCbConfig_t »pCBConfigData, TelSmsCause_t 
SmsCause, int RequestId) 


This function is used to send a response for SMS CB configuration request. 


BOOL TelOemSmsGetParametersCnf (const TelSmsParams_t *pSmsParams, TelSmsCause_t Sms- 
Cause, int RequestId) 


This function is used to send the response for the TelOemSmsGetParametersReq. 


BOOL TelOemSmsDeleteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 


This function sends a confirmation to a delete request. 


BOOL TelOemSmsWiriteCnf (int SimIndex, TelSmsCause_t SmsCause, int RequestId) 


This function sends a confirmation to a write request. 


BOOL TelOemSmsSendDeliveryReportCnf (Tel8msResponse t SmsResponse, int RequestId) 


This function sends an acknowledgement to the upper layers whether the sms successfully sent or not. 


BOOL TelOemSmsSetPreferredBearerCnf (TelSmsResponse t Status, int RequestId) 


This function is used to send a confirmation for the TelOemSmsSetPreferredBearerReq. 


BOOL TelOemSmsSetSCACnf (TelSmsResponse_t Status) 


This function is used to send a confirmation for the set SCA request. 


BOOL TelOemSmsCBSetConfigCnf (TelSmsResponse t Status, int RequestId) 


This function is used to send a confirmation for the set CB configuration request. 


BOOL TelOemSmsSetParametersCnf (TelSmsResponse_t Status, int RequestId) 


This function is used to send a confirmation for the set Parameters request. 


BOOL TelOemSmsGetPreferredBearerCnf (const TelSmsBearerType_t SmsBearer, TelSmsCause_t 
SmsCause, int RequestId) 


This function used to send the response to a TelOemSmsGetPreferredBearerReq. 


BOOL TelOemSmsGetCountCnf (const Tel8msStoredMsgCountInfo t »pMsgCountInfo, TelSms- 
Cause t SmsCause, int RequestId) 


This function is used to retrieve message count and the list from sim storage. 


BOOL TelOemSmsCBIncomingInd (const Tel8msCbMsg t *pCBMsglInfo) 


This function is used to inform about an incoming cell broadcast service for GSM and UMTS. 
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• BOOL TelOemSmsIncomingInd (const TelSmsDatapackageInfo_t «pDataPackage) 


This function is used to inform about an incoming normal SMS. SMS-DELIVER message structure should 
be in TPDU format as specified by 3GPP TS 23.040 SMS TPDU. 


* BOOL TelOemSmsMemoryStatusInd (BOOL bStatus) 


This function is used to inform the memory status i.e EF-SMS memory is Full or available, to the application. 
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7.5 OemTapiNetwork.h File Reference 


7.5.1 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI Network Module. 


#include "TapiCommon.h" 


#include "TelNetwork.h" 


Functions 


е TapiResult г TelOemNwSetConfigurationReq (const TelNetworkConfigSettings t *pConfig- 
NetworkInfo) 


This function sets the network configuration preferences at OEM Telephony provider based on which net- 
work selection/registration/ camping has to be performed . 


• TapiResult t TelOemNwSelectNetworkReq (const TelNetworkSystemId t *pSystemId) 


This function provides information to the underlying OEM provider to select a network. 


e TapiResult t TelOemNwSearchNetworkReq (void) 


This function requests the underlying OEM provider to manually search for available networks. 


* TapiResult t TelOemNwGetNetworkInfoReq (void) 


This function requests the underlying OEM provider for current network's status information. 


• TapiResult t TelOemNwSetSelectionModeReq (TelNetworkSelectionMode t SelectionMode) 


This function configures network selection mode in the underlying OEM provider with options of Automatic 
selection or Manual selection based on which network selection procedure can happen. 


* TapiResult t TelOemNwGetSelectionModeReq (void) 


This function returns the currently set network selection mode in the underlying OEM provider - whether 
automatic or manual. 


* TapiResult t TelOemNwCancelManualSearchReq (void) 


This function is used to cancel the manual network search and it can be called in the following scenarios a) 
When user wants to cancel already triggered Manual Search b) When user wants to cancel the registration 
of selected network from manual network list. 


e TapiResult t TelOemNwCancelManualSelectionReq (void) 


This function is used to cancel the manual network where user has already selected a network from the 
network list. 


e TapiResult t TelOemNwSetServiceDomainReq (TelNetworkServiceDomain, t ServiceDomain) 


This function provides the network service domain preference of the application. Based on service domain 
preference, OEM Telephony provider has to attach with the network for CS/PS/Both. 


е TapiResult t TelOemNwSetNetworkOrderReq (TelNetworkMode t *pNwMode) 


This function provides the preference of network order in which the underlying OEM Telephony provider 
can select and camp on network. 
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* TapiResult t TelOemNwSetNetworkModeReq (TelNetworkMode t NetworkMode) 


This function configures network mode in the underlying OEM provider with any of these options Automatic, 
GSM 900/1800, GSM 1900 or WCDMA. 


• TapiResult t TelOemNwsSetNetworkBandReq (TelNetworkBandPreferred_t BandPref, TelNetwork- 
Band. t Band) 


This function is invoked to enable or disable power on attach. 


• BOOL TelOemNwRadioInfoInd (const TelNetworkRadioInfo_t «pRadioInfo) 


This function is an Indication from the OEM provider of the Radio information. 


e BOOL TelOemNwSearchNetworkInd (const TelNetworkList t *pNetworkList) 


This function is an Indication from the OEM provider after a network search without any request from 
Telephony Server for Manual search. 


* BOOL TelOemNwChangedInd (const TelNetworkInfo t xpNetworkInfo) 


This function is used to indicate the any change in network selection/registration in the modem. As Modem 
has its own Automatic Network selection procedures due to which there can be change in currently camped 
network and service level based on signal strength etc. If there is a change in network information, Modem 
can automatically trigger this API with all the network information. 


e BOOL TelOemNwSelectNetworkCnf (const TelNetworkInfo t *pNetworkInfo, TelNetwork- 
OperationCause t OpCause) 


This function is used to send the confirmation for setting the configuration at the lower layers. 


e BOOL TelOemNwSearchNetworkCnf (const TelNetworkList t *pNetworkList, TelNetwork- 
OperationCause t OpCause) 


This function requests the underlying OEM provider to manually search for available networks and present 
the network list to the user. 


e BOOL TelOemNwGetSelectionModeCnf (TelNetworkSelectionMode t SelectionMode, Tel- 
NetworkOperationCause t OpCause) 


This functions sends a confirmation for the get network selection mode request. 


e BOOL TelOemN wGetNetworkInfoCnf (const TelNetworkInfo t *pNetworkInfo, TelNetwork- 
OperationCause t OpCause) 


This function used to send a response for the get network info request. 


* BOOL TelOemNwCancelManualSearchCnf (TelNetworkOperationCause t OpCause) 


This function sends a confirmation for the cancel select network request. 


* BOOL TelOemNwCancelManualSelectionCnf (TelNetworkOperationCause t OpCause) 


This function sends a confirmation for the cancel manual network selection request. 


• BOOL TelOemNwSetNetworkOrderCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network order. 


• BOOL TelOemNwSetNetworkModeCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network Mode. 
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BOOL TelOemNwsetSelectionModeCnf (TelNetworkOperationCause t OpCause) 


This functions sends a confirmation for the set network selection mode request. 


BOOL TelOemNwSetNetworkBandCnf (TelNetworkOperationCause t OpCause) 


This function is a response from the OEM provider for setting the network Band. 


BOOL TelOemNwsetServiceDomainCnf (TelNetworkOperationCause t OpCause) 


This function used to send a confirmation for setting service domain at the lower layers. 


BOOL TelOemN wsSetConfigurationCnf (TelNetworkOperationCause_t OpCause) 


This function is used to send the confirmation for setting the configuration at the lower layers. 
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7.6 OemTapiSim.h File Reference 


7.6.1 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI SIM Module. 


Note: Phonebook APIs are 2G SIM Specific in R1 timeframe. Some Operator may have support only 3G 
Phonebook. 


In this case, 2G SIM Phonebook APIs may return ТАРІ АРІ NOT SUPPORTED as an error value іп 
TapiResult t. 


Functions 


е TapiResult t TelOemSimChangePINReq (TelSimPinType t PinType, const char «pOldPinData, 
const char *pNewPinData, int RequestId) 


This function changes PIN1 or PIN2 code based on the pin type passed along with old pin data and new pin 
data. 


е TapiResult t TelOemSimVerifyPINReq (const TelSimPinData t «pPinData, int RequestId) 


This function performs PIN verification. This function performs PIN1 or PIN2 verification based on the pin 
type passed along with current pin data. This function could be also explicitly used to retrieve the remaining 
PIN retry counter in case there is no data (PIN code) passed in the command. 


е TapiResult t TelOemSimUnblockPINReq (const TelSimPinData t *pPukPinData, const char *р- 
NewPinData, int RequestId) 


This function performs unblock РІМІ or PIN2 based on PUKI/PUK2 pin type passed along with unblock 
information passed from telephony server. 


е TapiResult t TelOemSimEnablePINReq (const TelSimPinData t *pPinData, int RequestId) 
This function enables PIN lock (Pinl ). 


* TapiResult t TelOemSimDisablePINReq (const TelSimPinData t «pPinData, int RequestId) 
This function disables or unlocks the PIN(PIN1). 


е TapiResult t TelOemSimGetFileInfoReq (const TelSimFileID t *pFileld, int RequestId) 


This function is called to pass the request to OEM telephony provider to fetch the Elementary File informa- 
tion. 


e TapiResult t TelOemSimReadFileReq (const TelSimReadFileRequestData t *pReadFileReqData, 
int RequestId) 


This function is called in order pass the request for reading Elementary file from SIM. 


е TapiResult t TelOemSimUpdateFileReq (const TelSimUpdateFileRequestData t *pUpdateFileReq- 
Data, int RequestId) 


This function is passed to OEM provider in order to update records in an Elementary file. 


e TapiResult t TelOemSimEnableFDNReq (const char «pPinData, int RequestId) 


This function enables FDN at the lower layers by accepting the PIN2 information entered by the user. 
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TapiResult t TelOemSimDisableFDNReq (const char «pPinData, int RequestId) 


This function initiates disabling FDN in the lower layers with the PIN2 data entered by the user. 


TapiResult t TelOemSimGetPINInfoReq (TelSimPinType t PinType, int RequestId) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 


TapiResult t TelOemSimPbGetStorageCountReq  (TelSimPbFileType t StorageFileType, int 
RequestId) 


This API is used to get number of used PB records and total records in SIM phone book files. This API is 
only applicable to GSM phonebook. 


TapiResult t TelOemSimPbGetEntryInfoReq (TelSimPbFileType t StorageFileType, int Request- 
Id) 


This API is used to get max text length and max number length supported by SIM phone book files. 


TapiResult t TelOemSimPbReadRecordReq (TelSimPbFileType t StorageFileType, unsigned short 
Index, int RequestId) 


This API is used to read sim phone book entry information. A phonebook entry information consists of the 
record in EF-ADN. 


TapiResult t TelOemSimPbUpdateRecordReq (const TelSimPbRecordData t *pPbUpdateData, int 
RequestId) 


This API is used to add or edit sim phone book entry information. 


TapiResult t TelOemSimPbDeleteRecordReq (TelSimPbFileType t StorageFileType, unsigned 
short Index, int RequestId) 


This API is used for deleting a SIM phone book record. 


BOOL TelOemSimChangePINCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimChangePINReq. 


BOOL TelOemSimVerifyPINCnf (const TelSimPinInfo t *pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimVerifyPINReq. 


BOOL TelOemSimUnblockPINCnf (const TelSimPinInfo t »*pPinInfo, TelSimPinOperation- 
Result t OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimUnblockPINReq. 


BOOL TelOemSimEnablePINCnf (const TelSimPinInfo_t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimEnablePINReq. 


BOOL TelOemSimDisablePINCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimDisablePINReq. 


BOOL TelOemSimGetFileInfoCnf (const TelSimFileInfo t *pFileInfo, TelSimAccessResult - 
t AccessResult, int RequestId) 
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This function sends the confirmation to the upper layers for the TelOemSimGetFileInfoReq. 


e BOOL TelOemSimReadFileCnf (const TelSimReadFileData t *xpReadData, TelSimAccessResult t 
AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimReadFileReq. 


• BOOL TelOemSimUpdateFileCnf (const TelSimFileAccessGeneralResp. t *pUpdateData, TelSim- 
AccessResult. t AccessResult, int RequestId) 


This function sends the confirmation to the upper layers for the TelOemSimUpdateFileReq. 


• BOOL TelOemSimEnableFDNCnf (TelSimPinOperationResult t OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimEnableFDNReq. 


* BOOL TelOemSimDisableFDNCnf (TelSimPinOperationResult t OpResult, int RequestId) 
This function sends the confirmation to the upper layers for the TelOemSimDisableFDNReq. 


• BOOL TelOemSimGetPINInfoCnf (const TelSimPinInfo t «pPinInfo, TelSimPinOperationResult t 
OpResult, int RequestId) 


This function is called to get the remaining PIN/PUK verification attempts left to verify against SIM 
PIN/PUK. 


• BOOL TelOemSimPbGetStorageCountCnf (const TelSimPbStorageInfo t *pStorageInfo, TelSim- 
AccessResult_t PbAccessResult, int RequestId) 


This function is called to send a confirmation to the upper layers for the TelOemSimPbGetStorage CountReq 
API. 


• BOOL TelOemSimPbGetEntryInfoCnf (const TelSimPbEntryInfo t *pPbEntryInfo, TelSimAccess- 
Result t PbAccessResult, int RequestId) 


This API is used to get max text length and max number length supported by SIM phone book files. This 
function is called to send a confirmation to the upper layers for TelOemSimPbGetEntryInfoReq API. 


e BOOL TelOemSimPbReadRecordCnf (const TelSimPbRecordData t «pPbReadResponse, TelSim- 
AccessResult, t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbReadRecordReq API. 


e BOOL TelOemSimPbUpdateRecordCnf (const TelSimPbUpdateResp t *«pPbUpdateResp, TelSim- 
AccessResult_t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbUpdateRecordReq API. 


e BOOL TelOemSimPbDeleteRecordCnf (const TelSimPbUpdateResp t *pPbDeleteResp, TelSim- 
AccessResult_t PbAccessResult, int RequestId) 


This function is called to send the confirmation for TelOemSimPbDeleteRecordReq API. 


* BOOL TelOemSimCardStatusInd (TelSimCardStatus_t CardStatus) 


This function sends the indication to the upper layers regarding the SIM card status during SIM Initialization 
or Card not present/ Card gone bad / Card Blocked(both Pin and PUK blocked). 


• BOOL TelOemSimCardTypelnd (TelSimCardType t CardType) 


This function sends the indication to the upper layers regarding the SIM card type at the time of boot-up. 
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7.7 OemTapiSS.h File Reference 


7.7.4 Detailed Description 


This file defines the function prototypes for OEM layer for TAPI SS Module. 


Note: Supplementary services are dependent on Operator/Market/Vendor. If any of Supplementary Service 
is 


not supported in underlying telephony provider due to dependencies, then SS APIs may return an error 


TAPI API NOT SUPPORTED from OEM Adaptation layer. 


#include "TapiCommon.h" 


Functions 


е TapiResult t TelOemSsSetCallBarringReq (const TelSsCallBarringInfo t *pBarInfo, int Request- 
Id) 


This function requests lower layers to activate/deactivate Call Barring depends on the barring type (incom- 
ing or outgoing) on NW side. 


e TapiResult t TelOemSsChangeBarPasswordReq (const char *pOldPassword, const char «pNew- 
Password) 


This function requests lower layers to change the call barring password stored in NW to a new password. 


* TapiResult t TelOemSsGetCallBarringStatusReq (TelSsCallBarType t BarType, TelSsCallType - 
t Call Type, int RequestId) 


This function requests lower layers to fetch the Call Barring status from NW. 


е TapiResult t TelOemSsSetCallForwardReq (const TelSsForwardInfo t *pCallFwdInfo, int Request- 
Id) 


This function passes Register/Activate/Deactivate/Erase Call Forward request to low layers. This service 
permits a called mobile subscriber to have the network send all incoming calls (speech and data) which 
meet various call FORWARD condition to another directory number. Various conditions are busy, not 
reachable, not answering, and unconditional. The ability of the served mobile subscriber to originate calls 
is unaffected. If the service is activated, a call is forwarded only if under this call FORWARD condition. 


* TapiResult t TelOemSsGetCallForwardStatusReq (TelSsForwardType t FwdType, TelSsForward- 
When, t Condition, int RequestId) 


This function requests Call Forwarding status from NW. 


e TapiResult t TelOemSsSetCallWaitingReq (BOOL bCwStatus, int RequestId) 


This function passes requests to activate/deactivate call waiting on NW side for all applicable basic services. 


e TapiResult t TelOemSsGetCallWaitingStatusReq (int RequestId) 


This function requests lower layer to interrogate Call Waiting status on NW side. 


е TapiResult t TelOemSsSendUssdReq (const TelSsUssdMsgInfo t *pUssdMsgInfo) 
This API triggers the underlying Supplementary service protocol to send the USSD data to the network. 


* TapiResult t TelOemSsQueryCapabilityInfoReq () 
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This function interrogates about the available supplementary services at lower layers. 


е TapiResult t TelOemSsSendUssdUserRsp (const TelSsUssdMsgInfo t *pUssdMsgInfo, TelSs- 
Cause. t Cause) 


This function sends the response for the USSD indication . 


e TapiResult t TelOemSsVerifyBarPwdRsp (const char *pBarringPwd) 


This function provides a response to a get password indication which was requested by the network through 
TelOemSsGetPwdlnd . 


• BOOL TelOemSsSetCallBarringCnf (TelSsCause t Cause, const TelSsInfo t *pSsInfo, int Request- 
Id) 


This function gives the response of TelOemSsSetCallBarringReq to the upper layers, from the network. 


* BOOL TelOemSsChangeBarPasswordCnf (TelSsCause t Cause) 


This function sends the confirmation for the change of call barring password from lower layers. 


e BOOL TelOemSsGetCallBarringStatusCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int 
RequestId) 


This function returns the confirmation of the call barring status from the lower layers. 


e BOOL TelOemSsSetCallForwardCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int Request- 
Id) 


This function passes Register/Activate/Deactivate/Erase Call Forward confirmation to upper layers. 


e BOOL TelOemSsGetCallForwardStatusCnf (TelSsCause t Cause, const TelSsInfo t «pSsInfo, int 
RequestId) 


This function is the confirmation for TelOemSsGetCallForwardStatusReq call from the lower layers to the 
Telephony Server. 


e BOOL TelOemSsSetCallWaitingCnf (TelSsCause t Cause, const TelSsInfo t *pSsInfo, int Request- 
Id) 


This function passes the confirmation for the TelOemSsSetCallWaitingReq call from the lower layers. 


e BOOL TelOemSsGetCall WaitingStatusCnf (TelSsCause t Cause, const TelSsInfo t *pSsInfo, int 
RequestId) 


This function passes the call waiting status result from the lower layers to Telephony Server. 


e BOOL TelOemSsSendUssdCnf (const TelSsUssdMsgInfo t *pUssdMsgInfo,  TelSsCause - 
t Cause) 


This function will be called to provide the final USSD confirmation once USSD Transaction is complete. 


e BOOL TelOemSsUssdInd (const TelSsUssdMsgInfo_t *pUssdMsglInfo) 


This function sends the unsolicited indication of the USSD String received from the network to the upper lay- 
ers. This function is called to indicate unsolicited indication which can be an intermediate USSD message 
during a USSD session or it can new USSD session initiated by the network to UE. 


e BOOL TelOemSsQueryCapabilityInfoCnf (TelSsCause t Cause, const TelSsCapabilityInfo_t жр55- 
CapInfo) 


This function sends the confirmation for the supported SS services query at the lower layers. 
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• BOOL TelOemSsGetPwdlInd (TelSsCallBarType t PwdType) 


This function sends the Indication of the get password request to the upper layers which is received from 
network. 
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7.8 TelCall.h File Reference 


7.8.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Call Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelCallCugInfo t 

struct TelCallingNamelInfo t 
struct TelCallUusInfo t 

struct TelCallSetupParams t 
struct TelCallStatus t 

struct TelCallUserDataInfo t 
struct TelCallEndInfo t 

struct TelCallRedirectionInfo t 
struct TelCallIncomingCallInfo t 


Defines 


• #define ТАРІ CALLING. NAME SIZE MAX 80 
* #define TAPI CALL UUS DATA LEN MAX 131 


Enumerations 


* enum TelCallCause t { 


TAPI CAUSE SUCCESS, TAPI CAUSE ACCESSDISCARD, TAPI CAUSE BARR - 
BYOPERATOR, TAPI CAUSE BEARERMODE NOTIMPL, 


TAPI CAUSE BEARERMODE RESTRICTED, TAPI CAUSE BEARERMODE UNAUTH, 
TAPI CAUSE BEARERMODE UNAVAIL, TAPI CAUSE BUSY, 


TAPI CAUSE CALLMETER EXPIRED, TAPI CAUSE CALLNO ERROR, TAPI CAUSE - 
CKTUNAVAIL, TAPI CAUSE CONGESTION, 


TAPI CAUSE NO CIRCUIT AVAIL, TAPI CAUSE DESTIN INCOMPAT, TAPI CAUSE - 
DTMF NOSPEECH, TAPI CAUSE DTMF REJECTED, 


TAPI CAUSE FACILITY NOTIMPL, TAPI CAUSE FACILITY NOTSUBSCRIBED, TAPI - 
CAUSE INCOMINGCUGCALLS BARRED, TAPI CAUSE INVALNUM, 


TAPI CAUSE MPTY ERROR, TAPI CAUSE NOANSWER, TAPI CAUSE - 
NONCUGMEMBER, TAPI CAUSE NUMBERCHANGED, 
TAPI CAUSE NUMBER ERROR, TAPI CAUSE NWFAILURE, TAPI CAUSE - 


OPERATIONUNAVAIL, TAPI CAUSE OUTOFORDER, 


TAPI CAUSE PROTOCOL ERROR, TAPI CAUSE QOSUNAVAIL, TAPI CAUSE REJECT, 
TAPI CAUSE REJ FAIL, 


ТАРІ CAUSE КЕЈ SRVC NOT АУ, ТАРІ CAUSE REMOTE CKTUNAVAIL, ТАРІ - 
CAUSE RESOURCEUNAVAIL, TAPI CAUSE SERVICEID ERROR, 
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ТАРІ CAUSE SERVICE NOTIMPL, ТАРІ CAUSE SERVICE UNAVAIL, ТАРІ CAUSE - 
MODIFY SAME BEARER, TAPI CAUSE MODIFY NOT PERMITTED, 


TAPI CAUSE HOLD FAIL, TAPI CAUSE TEMPFAILURE, TAPI CAUSE WRONGNUM, 
TAPI CAUSE NORMAL UNSPECIFIED, 

TAPI CAUSE SSERRINVALIDTIVALUE, TAPI CAUSE SSERRINVALIDTI, TAPI CAUSE - 
SSINCOMPATIBLESTATE, TAPI CAUSE SSERRSYNTAXERROR, 

TAPI CAUSE SSPROTOCOLERROR, ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK, 
ТАРІ CAUSE SSSENTASPHASEI, ТАРІ CAUSE SSERROR, 

TAPI CAUSE SS USSD BUSY, TAPI CAUSE IDLE, TAPI CAUSE NETWORK SPECIFIC, 
TAPI CAUSE FADE, 

TAPI CAUSE UNKNOWN, ТАРІ CAUSE INCOM CALL, ТАРІ CAUSE ALERT STOP, 
TAPI CAUSE INTERCEPT, 

TAPI CAUSE REORDER, TAPI CAUSE CLIENT END, TAPI CAUSE ACCESS CLASS - 
BLOCKED, TAPI CAUSE MEMCAPEXCEEDED, 

ТАРІ CAUSE TYPENOTSUPPORTED, ТАРІ CAUSE REPLACENOTSUPPORTED, ТАРІ - 
CAUSE PROTOCOLID ERROR, TAPI CAUSE CLASSNOTSUPPORTED, 


TAPI CAUSE DATACODING ERROR, TAPI CAUSE INVAL MSG, TAPI CAUSE CALL - 
BARRED, TAPI CAUSE SIM CALL CONTROL CHANGED TO SS, 


TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL, TAPI CAUSE SIM ERROR, 
TAPI CAUSE SIM CALL CONTROL MODIFIED, TAPI CAUSE RANDOM ACCESS - 
FAILURE, 
TAPI CAUSE LOWER LAYER FAILURE, ТАРІ CAUSE ACCESS REJECTED, ТАРІ - 
CAUSE REEST NOT ALLOWED, TAPI CAUSE EMERGENCY CALL NOT ALLOWED, 


TAPI CAUSE ACCESS NOT ALLOWED, TAPI CAUSE RADIO LINK FAILURE, TAPI - 
CAUSE INVALID IDENTITY, TAPI CAUSE UNKNOWN IDENTITY, 

TAPI CAUSE UNACCEPTABLE IDENTITY, TAPI CAUSE NO SERVICE HERE, TAPI - 
CAUSE SERVICE NOT ALLOWED, TAPI CAUSE SERVICE NOT AVAIL, 

TAPI CAUSE SERVICE NOT WORKING, TAPI CAUSE CANNOT IDENTIFY CALL, 
TAPI CAUSE DEACTIVATION, TAPI CAUSE FATAL ERROR } 

enum TelCallAnswerType t { ТАРІ CALL ANSWER ACCEPT = 0, ТАРІ CALL ANSWER - 
REJECT = 1 } 

enum TelCallType t ( TAPI CALL TYPE VOICE, TAPI CALL TYPE DATA, TAPI CALL - 
TYPE E911 } 

enum TelCallAlertingPattern t { 


ТАРІ CALL ALERTING PATTERN 1 = 0x00, ТАРІ CALL АГЕКТІМС PATTERN 2 = 0x01, 
ТАРІ САШ, ALERTING PATTERN 3 = 0x02, ТАРІ CALL ALERTING PATTERN 4 = 0x03, 


ТАРІ CALL ALERTING PATTERN 5 = 0x04, ТАРІ CALL АГЕКТІМС PATTERN 6 = 0x05, 
ТАРІ CALL ALERTING PATTERN 7 = 0x06, ТАРІ CALL ALERTING PATTERN 8 = 0x07, 
TAPI CALL NO ALERTING PATTERN = 0x08 } 

enum  TelCallActivestate t { ТАРІ CALL CONNECT IDLE, ТАРІ CALL CONNECT - 
ACTIVE, TAPI CALL CONNECT HELD ] 

enum TelCallIdentityMode t ( TAPI CALL IDENTITY DEFAULT, TAPI CALL IDENTITY - 
SHOW, TAPI CALL IDENTITY HIDE } 

enum TelCallCugOptions t { TAPI CALL CUG NO INFO = 0x00, TAPI CALL CUG - 
SUPRESS OA, ТАРІ CALL СОС SUPRESS РКЕ СОС, ТАРІ CALL СОС SUPRESS OA - 
AND ССС) 

enum TelCallUusType t ( TAPI CALL UUS NONE, TAPI CALL UUS 1) 
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* enum TelCallUusProtocolType t { 


TAPI CALL UUS PROTO SPECIFIC - 0, TAPI CALL UUS PROTO OSI HIGHER LAYER 
= 1, ТАРІ CALL UUS PROTO IA5 CHARS = 4, ТАРІ CALL UUS PROTO V120 = 7, 


TAPI CALL UUS PROTO 0931-8) 
enum TelCallNameMode t { ТАРІ CALL NAME AVAIL = 0, ТАРІ CALL NAME - 


RESTRICTED = 1, TAPI CALL NAME UNAVAIL = 2, TAPI CALL NAME AVAIL - 
RESTRICTED = 3] 
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7.9 TelNetText.h File Reference 


7.9.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Network Text Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


#include "ITapiSim.h" 


#include "tapi utility.h" 


#include "TapiCommon.h" 


Data Structures 


struct TelSmsCbConfig_t 

struct TelSmsAddressInfo t 

struct TelSmsParams t 

struct TelSmsDatapackagelInfo_t 
struct TelSmsData t 

struct TelSmsStoredMsgCountInfo_t 
struct TelSmsCbMsg t 


Defines 


#define TAPI NETTEXT CB PAGE SIZE MAX 93 

fdefine TAPI NETTEXT GSM SMS MSG NUM MAX 90 

fdefine TAPI NETTEXT GSM SMS CBMI LIST SIZE MAX 60 

fdefine TAPI NETTEXT SMDATA SIZE MAX 160 

#define TAPI NETTEXT MAX GSM SMS SERVICE CENTER ADDR 12 
#define TAPI NETTEXT MAX INDEX 255 

#define TAPI SIM SMSP ADDRESS LEN 20 

#define TAPI SIM SMSP ALPHA ID LEN MAX 32 


Enumerations 


• enum TelSmsMsgStatus_t { 


TAPI NETTEXT STATUS READ, TAPI NETTEXT STATUS UNREAD, TAPI NETTEXT - 
STATUS SENT, TAPI NETTEXT STATUS UNSENT, 


TAPI NETTEXT STATUS DELIVERED, TAPI NETTEXT STATUS DELIVERY - 
UNCONFIRMED, ТАРІ NETTEXT STATUS MESSAGE REPLACED, ТАРІ NETTEXT - 
STATUS RESERVED } 

enum TelSmsBearerType t ( 


TAPI NETTEXT BEARER PS ONLY - 0x01, TAPI NETTEXT BEARER CS ONLY, TAPI - 
NETTEXT BEARER PS PREFERRED, TAPI NETTEXT BEARER CS PREFERRED, 


TAPI NETTEXT NO PREFERRED BEARER } 

enum TelSmsCbMsgType t { ТАРІ NETTEXT CB MSG CBS = 1, ТАРІ NETTEXT - 
CB MSG SCHEDULE, ТАРІ NETTEXT CB MSG СВ541, ТАРІ NETTEXT CB MSG - 
INVALID } 
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enum TelSmsResponse t { 


ТАРІ NETTEXT SENDSMS SUCCESS = 0x00, TAPI NETTEXT ROUTING NOT - 
AVAILABLE, TAPI NETTEXT INVALID PARAMETER, TAPI NETTEXT DEVICE - 
FAILURE, 


ТАРІ NETTEXT SERVICE RESERVED, ТАРІ NETTEXT INVALID LOCATION, ТАРІ - 
NETTEXT NO SIM, TAPI NETTEXT SIM NOT READY, 


TAPI NETTEXT NO NETWORK RESP, TAPI NETTEXT DEST ADDRESS FDN - 
RESTRICTED, ТАРІ NETTEXT SCADDRESS FDN RESTRICTED, ТАРІ NETTEXT - 
RESEND ALREADY DONE, 


TAPI NETTEXT SCADDRESS NOT AVAILABLE, TAPI NETTEXT UNASSIGNED - 
NUMBER, ТАРІ NETTEXT OPERATOR DETERMINED BARRING, ТАРІ NETTEXT - 
CALL BARRED, 


TAPI NETTEXT MESSAGE TRANSFER REJECTED, TAPI NETTEXT MEMORY - 
CAPACITY EXCEEDED, ТАРІ NETTEXT DESTINAITION OUTOFSERVICE, ТАРІ - 
NETTEXT UNSPECIFIED SUBSCRIBER, 


TAPI NETTEXT FACILITY REJECTED, TAPI NETTEXT UNKNOWN SUBSCRIBER, 
TAPI NETTEXT NETWORK. OUTOFORDER, TAPI NETTEXT TEMPORARY FAILURE, 


TAPI NETTEXT CONGESTION, TAPI NETTEXT RESOURCES UNAVAILABLE, 
TAPI NETTEXT FACILITY NOT SUBSCRIBED, TAPI NETTEXT FACILITY NOT - 
IMPLEMENTED, 


TAPI NETTEXT INVALID REF VALUE, TAPI NETTEXT INVALID MSG, TAPI - 
NETTEXT INVALID MANDATORY INFO, TAPI NETTEXT MESSAGE TYPE NOT - 
IMPLEMENTED, 


TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL, TAPI NETTEXT IE - 
NOT IMPLEMENTED, TAPI NETTEXT PROTOCOL ERROR, TAPI NETTEXT - 
INTERWORKING } 


enum TelSmsCause t { 


ТАРІ NETTEXT SUCCESS, ТАРІ NETTEXT INVALID PARAMETER FORMAT, ТАРІ - 
NETTEXT PHONE FAILURE, TAPI NETTEXT SIM BUSY, 


TAPI NETTEXT SIM FAILURE, TAPI NETTEXT UNKNOWN, TAPI NETTEXT - 
MEMORY FAILURE, TAPI NETTEXT OPERATION NOT SUPPORTED } 
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7.10 TelNetwork.h File Reference 


7.10.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Network Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelNetworkTimeAndZone t 
struct TelNetworkSystemlId t 
struct TelNetworkConfigSettings t 
struct TelNetworkInfo t 

struct TelNetworkList t 

struct TelNetworkRadioInfo t 


Defines 


• #define ТАРІ NETWORK ORDER MAX 5 

* #define TAPI NETWORK LIST MAX 15 

• #define ТАРІ NETWORK NAME LEN MAX 40 
е #define ТАРІ NETWORK SPN LEN MAX 20 


Enumerations 


e enum TelNetworkSelectionMode t { ТАРІ NETWORK. SELECTIONMODE AUTOMATIC, 
TAPI NETWORK. SELECTIONMODE MANUAL ] 


enum  TelNetworkSystemIdFormat t { TAPI NETWORK SYSID FORMAT SID, ТАРІ - 
NETWORK, SYSID FORMAT PLMN } 


enum TelNetworkServiceDomain t { ТАРІ NETWORK, SERVICE DOMAIN COMBINED, 
ТАРІ NETWORK. SERVICE DOMAIN PS, TAPI NETWORK. SERVICE DOMAIN. CS, 
TAPI NETWORK, SERVICE DOMAIN AUTOMATIC } 


enum TelNetworkMode t ( 

TAPI NETWORK MODE EMERGENCY, TAPI NETWORK. MODE AUTOMATIC, TAPI - 
NETWORK. MODE CDMA, TAPI NETWORK. MODE GSM, 

TAPI NETWORK, MODE WCDMA, TAPI NETWORK, MODE WLAN } 


enum  TelNetworkServiceLevel t { ТАРІ NETWORK SERVICE LEVEL МО, TAPI - 
NETWORK, SERVICE LEVEL EMERGENCY, TAPI NETWORK SERVICE LEVEL FULL, 
ТАРІ NETWORK, SERVICE LEVEL, SEARCH } 


enum TelNetworkServiceType t { 


TAPI NETWORK SERVICE TYPE NO SVE, TAPI NETWORK SERVICE TYPE - 
LIMITED, ТАРІ NETWORK. SERVICE TYPE CS, ТАРІ NETWORK SERVICE TYPE PS, 


TAPI NETWORK SERVICE TYPE COMBINED } 
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enum TelNetworkSystemType t { 


ТАРІ NETWORK SYSTEM ХО SRV, ТАРІ NETWORK. SYSTEM СОМА, TAPI - 
NETWORK, SYSTEM TDMA, ТАРІ NETWORK, SYSTEM GSM, 
ТАРІ NETWORK SYSTEM GPRS, TAPI NETWORK SYSTEM EGPRS, TAPI - 
NETWORK, SYSTEM PCS1900, TAPI NETWORK. SYSTEM UMTS, 
ТАРІ NETWORK, SYSTEM, GSM, AND ОМТ } 
e enum TelNetworkBandPreferred t { ТАРІ NETWORK, BAND MODE PREFERRED = 0x01, 
TAPI NETWORK, BAND MODE ONLY = 0x02 } 
enum TelNetworkBand. t { 


TAPI NETWORK BAND TYPE ANY - 0x00, TAPI NETWORK BAND TYPE GSMS50, 
TAPI NETWORK BAND TYPE GSM 900 1800, TAPI NETWORK BAND TYPE - 
GSM1900, 


ТАРІ NETWORK BAND TYPE GSM, ТАРІ NETWORK BAND TYPE WCDMA, ТАРІ - 
NETWORK, BAND TYPE WCDMAS50, ТАРІ NETWORK BAND TYPE WCDMAI900, 
ТАРІ NETWORK BAND TYPE WCDMA2100 ) 

enum TelNetworkOperationCause t { 


ТАРІ NETWORK NO ERR = 0x00, ТАРІ NETWORK OPERATION FAILED, ТАРІ - 
NETWORK PHONE IN USE ERR, TAPI NETWORK OFFLINE ERR, 


TAPI NETWORK. CONFIG, SETTINGS. FAILURE ERR, ТАРІ NETWORK. INTERNAL - 
FAILURE ERR | 

enum TelNetworkDayLightSavingAdj t { ТАРІ NETWORK. DLS. АП! NO. ADJUSTMENT, 
ТАРІ NETWORK. DLS ADJ PLUS ONE HOUR, ТАРІ NETWORK DLS PLUS TWO - 
HOUR } 
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7.11 TelSim.h File Reference 


7.11.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi SIM Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


#include "limo defines.h" 


#include "TapiCommon.h" 


Data Structures 


struct TelSimFileID t 

struct TelSimPinData t 

struct TelSimReadFileRequestData, t 
struct TelSimIccIdInfo. t 


struct TelSimImsilnfo t 


struct TelSimServiceTable t 
struct TelSimSstInfo t 

struct TelSimPinInfo t 

struct TelSimPb2gData t 
struct TelSimPbRecordData t 
struct TelSimEccInfo t 

struct TelUsimEccInfo t 
struct TelUSimServiceTable t 
struct TelSimUstInfo t 

struct TelSimPbStorageInfo t 
struct TelSimPbEntryInfo t 
struct TelSimPbReadResp t 
struct TelSimPbUpdateResp t 
struct TelSimLanguagelInfo t 
struct TelSimFileAccessGeneralResp t 


struct TelSimGroupldentifierInfo t 
struct TelSimEccData t 

struct TelSimStatusData t 

struct TelSimCallbackEvent t 
struct TelSimEvent t 

struct TelSimApnData t 


struct TelSimDeviceContextData t 


struct TelSimDeviceContext t 

struct TelSimFileInfo t 

struct TelSimReadFileData t 

struct TelSimUpdateFileRequestData t 
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Defines 


fdefine TAPI SIM PIN LENGTH 8 

#define TAPI SIM ICCIDLENGTH 10 

#define TAPI SIM ICCID PACKET LEN 10 

#define TAPI SIM ICCID MAX LEN 10 

#define TAPI SIM LP MAX LEN 30 

#define TAPI SIM LP PACKET MAX LEN 30 

#define ТАРІ SIM IMSI LEN 8 

#define TAPI SIM IMSI PACKET LEN 15 

#define ТАРІ SIM MCC CODE LEN 3 

#define TAPI SIM MNC CODE LEN 2 

#define TAPI SIM MSIN CODE LEN 10 

#define TAPI SIM NUM TEXT MAX LEN 256 

#define TAPI SIM SST MAX LEN 20 

#define TAPI SIM GSM SST SERVICE MAX COUNT 50 
fdefine TAPI SIM ECC CODE LEN 3 

fdefine TAPI SIM ECC ALPHA STRING LEN MAX 50 
#define ТАРІ TAPI SIM PBOOK ENTRY COUNT MAX 20 
fdefine TAPI SIM LI MAX LEN 30 

fdefine TAPI SIM LI PACKET MAX LEN 30 

#define TAPI SIM ACL MAX LEN 50 

#define TAPI SIM GROUP IDENTIFIER LEN MAX 10 
#define TAPI SIM ECC MAX LEN 15 

#define ТАРІ SIM UECC RECORD COUNT МАХ 5 
fdefine TAPI SIM UECC RECORD LEN MAX 50 


Enumerations 


enum TelSimCardType t ( TAPI SIM CARD TYPE UNKNOWN, TAPI SIM CARD TYPE - 
GSM, TAPI SIM CARD TYPE USIM } 

enum TelSimFileName t { 

TAPI SIM EFILE DIR = Ox2F00, TAPI SIM EFILE ICCID = Ox2FE2, TAPI SIM EFILE - 
ADN = 0x6F3A, ТАРІ SIM, EFILE FDN = 0x6F3B, 

TAPI SIM EFILE SMS = 0x6F3C, ТАРІ SIM. EFILE. CCP = 0x6F3D, TAPI SIM. ЕЕП,Е IMSI 
= 0х6Е07, ТАРІ SIM EFILE, SST = Ox6F38, 

TAPI SIM EFILE EST = 0х6Е56, ТАРІ SIM EFILE АСМ = 0х6Е39, TAPI SIM EFILE - 
MBDN = 0x6FC7, TAPI SIM  EFILE GIDI = Ox6F3E, 

TAPI SIM EFILE GID2 = Ox6F3F, TAPI SIM. EFILE. MSISDN = 0x6F40, TAPI SIM. EFILE - 
SMSP = 0x6F42, ТАРІ SIM EFILE, SMSS = Ox6F43, 

ТАРІ SIM EFILE ЕХТІ = 0x6F4A, TAPI SIM. ЕЕП,Е EXT2 = 0х6ҒАВ, TAPI SIM. EFILE LP 
= Ox2F05, ТАРІ SIM EFILE, ACM. MAX = 0x6F37, 

TAPI SIM EFILE РОСТ = 0х6Е41, ТАРІ SIM EFILE. CBMI = Ox6F45, ТАРІ SIM EFILE - 
PHASE = Ox6FAE, TAPI SIM. EFILE. SDN = Ox6F49, 

TAPI SIM EFILE EXT3 = 0x6F4C, ТАРІ SIM, EFILE BDN = 0х6ҒАр, TAPI SIM EFILE - 
EXTA = Ox6F4E, TAPI SIM, EFILE, ECC = 0x6FB7, 


TAPI SIM EFILE SPN = Ox6F46, ТАРІ SIM ЕЕП Е РММ = Ox6FC5, ТАРІ SIM EFILE IMG 
= Ox4F20, ТАРІ SIM EFILE USIM LI = 0x6F05, 
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TAPI SIM EFILE USIM IMSI = 0x6A07, ТАРІ SIM. EFILE USIM АСМ MAX = 0x6A37, 
TAPI SIM. EFILE USIM UST = 0x6A38, ТАРІ SIM EFILE USIM ACM = 0x6A39, 


TAPI SIM EFILE USIM SPN - 0x6A46, TAPI SIM EFILE USIM PUCT - 0x6A41, TAPI - 
SIM. EFILE USIM CBMI = 0x6A45, ТАРІ SIM EFILE USIM ECC = 0x6AB7, 


TAPI SIM EFILE USIM FDN = 0x6A3B, TAPI SIM EFILE USIM SMS = 0x6A3C, TAPI - 
SIM. EFILE USIM MSISDN = 0x6A40, ТАРІ SIM EFILE (ЗІМ SMSP = 0x6A42, 


TAPI SIM EFILE USIM SMSS = 0x6A43, ТАРІ SIM EFILE USIM SDN = 0x6A49, ТАРІ - 
SIM. EFILE USIM EXTI = 0X6A4A, ТАРІ SIM EFILE USIM EXT? = 0x6A4B, 


TAPI SIM EFILE USIM EXT3 = 0x6A4C, ТАРІ SIM ЕЕП Е USIM EXTA = 0x6A55, ТАРІ - 
SIM EFILE USIM ЕХТ5- 0x6A4E, ТАРІ SIM EFILE USIM ЕХТ6- 0x6FC8, 


ТАРІ SIM EFILE USIM CCP2 = 0x6A4F, ТАРІ SIM EFILE USIM HIDDEN KEY = 
Ox6FC3, ТАРІ SIM EFILE USIM BDN = 0х6А4р, ТАРІ SIM EFILE USIM MBDN 
Ox6FC7, 


ТАРІ SIM. EFILE USIM MBI = 0x6FC9, ТАРІ SIM EFILE USIM РНОМЕВООК РВК = 
Ox4FFO, ТАРІ SIM EFILE USIM PHONEBOOK ССРІ = Ox4FFE, ТАРІ SIM EFILE USIM - 
PHONEBOOK UID = 0x4FF8, 


TAPI SIM EFILE USIM PHONEBOOK PSC =  Ox4FFEB ТАРІ SIM EFILE ОІМ - 
PHONEBOOK CC = Ox4FEF, ТАРІ SIM EFILE USIM PHONEBOOK PUID = Ox4FEE, 
ТАРІ SIM. EFILE USIM PHONEBOOK ADN = 0x4FF1, 


TAPI SIM EFILE USIM PHONEBOOK ТАР =  Ox4FF2, TAPI SIM EFILE USIM - 
РНОМЕВООК РВС = 0х4ЕЕЗ, ТАРІ SIM EFILE USIM PHONEBOOK ЕХТІ = Ox4FFB, 
ТАРІ SIM. EFILE USIM РНОМЕВООК СКР = Ox4FF7, 


TAPI SIM EFILE USIM PHONEBOOK AAS =  Ox4FFC, ТАРІ SIM EFILE USIM - 
PHONEBOOK_AAS1 = Ox4FFD, ТАРІ SIM EFILE USIM PHONEBOOK GAS = O0x4FOE, 
TAPI SIM. EFILE USIM PHONEBOOK GASI = Ox4FOF, 


ТАРІ SIM EFILE USIM PHONEBOOK АМК =  Ox4FF4, TAPI SIM EFILE USIM - 
PHONEBOOK SNE = Ox4FF9, ТАРІ SIM EFILE USIM PHONEBOOK EMAIL = Ox4FFA, 
TAPI SIM EFILE USIM PHONEBOOK ANRA = Ox4F13, 


TAPI SIM EFILE USIM PHONEBOOK ANRB = 0х4Е14, ТАРІ SIM EFILE USIM - 
PHONEBOOK ANRC = Ox4F15, TAPI SIM EFILE USIM PHONEBOOK ANRI = Ox4F16, 
TAPI SIM. EFILE USIM PHONEBOOK ANRAI = 0x4F17, 


ТАРІ SIM EFILE USIM PHONEBOOK АМКВІ = Ox4F18, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRCI = Ox4F21, ТАРІ SIM EFILE USIM РНОМЕВООК ADNI = Ox4F1A, 
ТАРІ SIM. EFILE USIM PHONEBOOK РВСІ = 0x4F1B, 


TAPI SIM EFILE USIM РНОМЕВООК СЕРІ =  Ox4FIC, ТАРІ SIM EFILE ОІМ - 
РНОМЕВООК SNEI! = Ox4FID, ТАРІ SIM EFILE USIM PHONEBOOK UIDI = Ox4FIE, 
ТАРІ SIM EFILE USIM РНОМЕВООК EMAILI = Ox4F1F, 


TAPI SIM EFILE USIM PHONEBOOK ТАРІ = 0х4ЕЕ5, ТАРІ SIM EFILE TELECOM - 
PHONEBOOK PBR = 0x4F30, TAPI SIM EFILE TELECOM РНОМЕВООК РВКІ = 0x4F29, 
ТАРІ SIM EFILE TELECOM PHONEBOOK РВК2 = 0x4F28, 


ТАРІ SIM EFILE TELECOM PHONEBOOK CCP] =  Ox4F3D, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK UID = Ox4F00, ТАРІ SIM EFILE TELECOM PHONEBOOK PSC 
= Ox4F22, ТАРІ SIM EFILE TELECOM PHONEBOOK CC = 0x4F23, 


ТАРІ SIM EFILE TELECOM PHONEBOOK PUID = 0х4Е24, TAPI SIM EFILE - 
TELECOM PHONEBOOK ADN = 0x4F3A, TAPI SIM EFILE TELECOM PHONEBOOK - 
ТАР = 0х4Е25, TAPI SIM EFILE TELECOM PHONEBOOK PBC = 0x4F09, 


TAPI SIM EFILE TELECOM PHONEBOOK EXTI =  Ox4F4A, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK GRP = 0х4Е26, TAPI SIM EFILE TELECOM PHONEBOOK - 
AAS = 0x4F4B, ТАРІ SIM EFILE TELECOM PHONEBOOK GAS = Ox4F4C, 
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ТАРІ SIM EFILE TELECOM PHONEBOOK АМА =  Ox4Fll, TAPI SIM EFILE - 
TELECOM PHONEBOOK SNE = 0x4F19, ТАРІ SIM EFILE TELECOM PHONEBOOK - 
EMAIL = Ox4F50, ТАРІ SIM EFILE TELECOM PHONEBOOK ANRA = 0x4F31, 


ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB =  Ox4F32, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ANRC = Ox4F40, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
ANRI = Ox4F33, ТАРІ SIM EFILE TELECOM, РНОМЕВООК ANRAI = 0x4F34, 
ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB1 =  Ox4F35, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ADNI = Ox4F36, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
РВСІ = Ox4F37, TAPI SIM EFILE TELECOM. РНОМЕВООК СЕРІ = 0x4F38, 
ТАРІ SIM EFILE TELECOM PHONEBOOK SNEI = Ox4F39, ТАРІ SIM. EFILE - 
TELECOM РНОМЕВООК UID1 = Ox4F3B, ТАРІ SIM EFILE TELECOM. PHONEBOOK - 
EMAIL] = 0x4F3C, ТАРІ SIM EFILE TELECOM, PHONEBOOK ТАРІ = Ox4F3E, 

TAPI SIM EFILE MSG WAITING INDICATION STATUS =  0x6FCA, ТАРІ SIM - 
EFILE INVALID = OxFFFF, ТАРІ SIM EFILE, OTHERS } 

enum TelSimFileType t { 

TAPI SIM FTYPE DEDICATED - 0x00, TAPI SIM FTYPE TRANSPARENT - 0x01, TAPI - 
SIM. FTYPE LINEAR FIXED - 0x02, TAPI SIM FTYPE CYCLIC - 0x04, 

ТАРІ SIM, FTYPE INVALID TYPE = OxFF } 

enum TelSimRecordMode t ( 

TAPI SIM. RECORD NONE = 0x00, TAPI SIM RECORD ABSOLUTE = 0x01, TAPI SIM - 
RECORD. CURRENT = 0x02, TAPI SIM. RECORD NEXT = 0x03, 

TAPI SIM RECORD PREVIOUS = 0x04, TAPI SIM, RECORD TO THE LAST = 0x05, 
TAPI SIM RECORD FROM, THE FIRST - 0x06 } 

enum TelSimPinStatus t { 

TAPI SIM. PIN STATUS DISABLED = 0x00, ТАРІ SIM PIN STATUS ENABLED = 0x01, 
TAPI SIM. PIN STATUS BLOCKED = 0x02, ТАРІ SIM. PIN STATUS РОК BLOCKED = 
0x03, 
ТАРІ SIM PIN STATUS UNKNOWN = OxFF } 

enum TelSimPinOperationResult t { 

TAPI SIM. PIN OPERATION SUCCESS, ТАРІ SIM, BUSY STATUS, ТАРІ SIM. CARD - 
ERROR, STATUS, TAPI SIM, INCOMPATIBLE PIN. OPERATION STATUS, 

TAPI SIM. PIN ІМСОККЕСТ PASSWORD STATUS, TAPI SIM. PIN2 REQD STATUS, 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS, ТАРІ SIM. РОК INCORRECT - 
PASSWORD STATUS, 

ТАРІ SIM. РОК REQD STATUS, ТАРІ SIM, PUK2 REQD STATUS ) 

enum TelSimAccessResult_t ( 

TAPI SIM. ACCESS. SUCCESS, ТАРІ SIM. ACCESS CARD ERROR, ТАРІ SIM, ACCESS - 
FILE NOT. FOUND, TAPI SIM ACCESS ACCESS CONDITION МОТ SATISFIED, 

TAPI SIM. ACCESS FAILED } 

enum TelSimPinType t { 

TAPI SIM PTYPE РІМІ = 0x00, ТАРІ SIM. PTYPE PIN2 = 0x01, ТАРІ SIM PTYPE РОКІ = 
0x02, ТАРІ SIM. PTYPE РОК2 = 0x03, 

TAPI SIM, PTYPE UPIN = 0x04, TAPI SIM PTYPE ADM = 0x05 } 

enum TelSimTypeOfNum t { 

TAPI SIM TON UNKNOWN = 0, TAPI SIM TON INTERNATIONAL = 1, TAPI SIM TON - 
NATIONAL = 2, ТАРІ SIM, TON. NETWORK, SPECIFIC = 3, 

TAPI SIM TON DEDICATED ACCESS = 4, ТАРІ SIM, TON. ALPHA, NUMERIC = 5, TAPI - 
SIM, TON ABBREVIATED NUMBER = 6, TAPI SIM TON RESERVED FOR EXT 27] 
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enum  TelSimTextEncrypt t { ТАРІ SIM TEXT ЕМС ASCIL ТАРІ SIM TEXT ENC - 
GSM7BIT, ТАРІ SIM TEXT ЕМС UCS2, ТАРІ SIM TEXT ЕМС HEX } 
enum TelSimPbFileType t { 


TAPI SIM PB FDN, TAPI SIM PB LDN, TAPI SIM PB MSISDN, TAPI SIM PB ADN, 


TAPI SIM PB SDN } 

enum TelSimPbAccessMode t { TAPI SIM PB ACCESS MODE ADD = 0x01, TAPI SIM - 
PB ACCESS MODE DEL = 0x02, ТАРІ SIM PB ACCESS МОРЕ EDIT = 0x03 } 

enum TelSimNumberingPlanIdentity_t { 

TAPI SIM NPI UNKNOWN = 0, TAPI SIM NPI ISDN TEL = 1, TAPI SIM NPI DATA - 
NUMBERING PLAN = 3, ТАРІ SIM NPI TELEX = 4, 

TAPI SIM NPI SVC CNTR SPECIFIC PLAN - 5, TAPI SIM NPI SVC CNTR SPECIFIC - 
PLAN? = 6, ТАРІ SIM NPI NATIONAL = 8, ТАРІ SIM NPI PRIVATE = 9, 

TAPI SIM NPI ERMES NUMBERING PLAN = 10, TAPI SIM NPI RESERVED FOR EXT 
= OxF } 

enum TelSimEccEmergencyServiceInfo t { 

TAPI SIM ECC ESC POLICE = 0x01, TAPI SIM ECC ESC AMBULANCE = 0x02, TAPI - 
SIM. ECC ESC FIREBRIGADE = 0x03, TAPI SIM ECC ESC MARAINEGUARD = 0x04, 
TAPI SIM ECC ESC MOUTAINRESCUE = 0x05, TAPI SIM ECC ESC SPARE = 0x00 } 
enum TelSimPbAccessResult. t ( 

TAPI SIM PB SUCCESS, TAPI SIM PB FAIL, TAPI SIM PB INVALID INDEX, TAPI - 
SIM PB INVALID NUMBER LENGTH, 

TAPI SIM PB INVALID NAME LENGTH, ТАРІ SIM PB ACCESS CONDITION NOT - 
SATISFIED } 

enum TelSimLangIndicationCode_t { 

TAPI SIM LI GERMAN = О, TAPI SIM LI ENGLISH = 0x01, TAPI SIM LI ITALIAN = 
0x02, ТАРІ SIM LI FRENCH = 0x03, 

TAPI SIM LI SPANISH = 0x04, TAPI SIM LI DUTCH = 0x05, TAPI SIM LI SWEDISH = 
0x06, ТАРІ SIM. LI DANISH = 0x07, 

TAPI SIM LI PORTUGUESE = 0x08, TAPI SIM LI FINNISH = 0x09, TAPI SIM LI - 
NORWEGIAN = 0x0A, ТАРІ SIM LI GREEK = OxOB, 

TAPI SIM LI TURKISH = 0х0С, TAPI SIM LI HUNGARIAN 
POLISH = OxOE, ТАРІ SIM LI LANG UNSPECIFIED = 0x0F } 
enum TelSimAccessType t { 

TAPI SIM. SELECT, ТАРІ SIM READ BINARY, ТАРІ SIM READ RECORD, ТАРІ SIM - 
GET RESPONSE, 

TAPI SIM UPDATE BINARY, TAPI SIM UPDATE RECORD, TAPI SIM STATUS } 

enum TelSimCardStatus t { 

TAPI SIM STATUS CARD ERROR = 0x00, TAPI SIM STATUS CARD NOT PRESENT = 
0x01, TAPI SIM STATUS SIM INITIALIZING = 0x02, TAPI SIM. STATUS SIM INIT - 
COMPLETED = 0x03, 

ТАРІ SIM STATUS SIM PIN REQUIRED = 0x04, ТАРІ SIM STATUS SIM РОК - 
REQUIRED = 0x05, TAPI SIM STATUS CARD BLOCKED = 0x06 } 

enum TelSimAcl t ( 

ТАРІ SIM ACL ALW = 0x00, ТАРІ SIM ACL PINI = 0x01, ТАРІ SIM ACL PIN2 = 0x02, 
ТАРІ SIM. ACL RFU = 0x04, 


ТАРІ SIM ACL ADM = 0x08, ТАРІ SIM ACL NEVER = OxFF } 


OxOD, TAPI SIM LI - 
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7.12 TelSs.h File Reference 


7.12.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi SS Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSsForwardInfo t 

struct TelSsUssdMsglInfo t 
struct TelSsCallBarringInfo t 
struct TelSsCliRecord t 

struct TelSsCallBarringRecord t 
struct TelSsForwardRecord_t 
struct TelSsCallWaitingRecord t 
union TelSsRecord t 

struct TelSsInfo t 

struct TelSsCapabilityInfo t 


Defines 


• #define ТАРІ SS С5М BARR PW LEN MAX 4 
• #define ТАРІ CALL DIALDIGIT LEN MAX 82 
* #define TAPI SS USSD DATA SIZE MAX 201 


Enumerations 


* enum TelSsForwardWhen t ( 


TAPI SS FORWARD WHEN UNCONDITIONAL EV, TAPI SS FORWARD WHEN - 
BUSY EV, TAPI SS FORWARD WHEN NO ANSWER EV, TAPI SS FORWARD WHEN - 
NOT REACHABLE EV, 

TAPI SS FORWARD WHEN ALL FORWARDING EV } 

enum TelSsCallBarType t { 


TAPI CALL BARRING ALL, ТАРІ CALL ВАККІМС OUTGOING, TAPI CALL - 


БАККІМС ALL OUTGOING. CALLS, TAPI CALL BARRING ALL OUTGOING - 
INTERN CALL, 
TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT, TAPI CALL - 


BARRING INCOMING, TAPI CALL BARRING ALL INCOMING CALLS, TAPI CALL - 
ВАВВІЧС ALL INCOMING CALLS. ROAMING, 

ТАРІ CALL BARRING. ALL INCOMING.  CALLS INSIM } 

enum TelSsTeleService t { 

TAPI SS TS ALL TELE AND BEARER SERVICES, TAPI SS TS ALL TELESERVICES, 
ТАРІ SS TS АШ, SPEECH, ТАРІ SS TS ALL DATA TELESERVICES, 


TAPI SS TS FACS, ТАРІ SS TS ALL TELESERVICES EXCEPT SMS, ТАРІ SS TS - 
ALL PLMN SPEC TELE, TAPI SS TS PLMN SPEC TELE 1, 
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ТАРІ SS TS PLMN SPEC TELE 2, ТАРІ SS TS PLMN SPEC TELE 3, ТАРІ SS TS - 
PLMN SPEC TELE 4, TAPI SS TS PLMN SPEC TELE 5, 

TAPI SS TS PLMN SPEC TELE 6, TAPI SS TS PLMN SPEC TELE 7, TAPI SS TS - 
PLMN SPEC TELE 8, TAPI SS TS PLMN SPEC TELE 9, 

TAPI SS TS PLMN SPEC TELE A, TAPI SS TS PLMN SPEC TELE B, TAPI SS TS - 
PLMN SPEC TELE C, TAPI SS TS PLMN SPEC TELE D, 

TAPI SS TS PLMN SPEC TELE E, TAPI SS TS PLMN SPEC TELE F, TAPI SS TS - 
PLMN SPEC TELE , TAPI SS BS ALL BEARER SERVICES, 

TAPI SS BS ALL DATA CDS, TAPI SS В5 ALL ASYNCHRONOUS, TAPI SS BS ALL - 
SYNCHRONOUS, TAPI SS BS DATA CIRCUIT SYNC, 

TAPI SS BS DATA CIRCUIT ASYNC, TAPI SS BS DATA ALL PDS, TAPI SS BS ALL - 
DATA. PADCA, ТАРІ SS BS ALL PLMN SPEC BS, 

TAPI SS BS PLMN SPEC TELE 1, TAPI SS BS PLMN SPEC TELE 2, TAPI SS BS - 
PLMN SPEC TELE 3, TAPI SS BS PLMN SPEC TELE 4, 

TAPI SS BS PLMN SPEC TELE 5, TAPI SS BS PLMN SPEC TELE 6, TAPI SS BS - 
PLMN SPEC TELE 7, TAPI SS BS PLMN SPEC TELE 8, 

TAPI SS BS PLMN SPEC TELE 9, TAPI SS BS PLMN SPEC TELE A, TAPI SS BS - 
PLMN SPEC TELE B, TAPI SS BS PLMN SPEC TELE C, 

TAPI SS BS PLMN SPEC TELE D, TAPI SS BS PLMN SPEC TELE E, TAPI SS BS - 
PLMN SPEC TELE F, TAPI SS TS ALL DATA, 

TAPI SS TS DATA CIRCUIT SYNC, TAPI SS TS MULTIPLE, TAPI SS TS TELEPHONY, 
TAPI SS TS DATA CIRCUIT ASYNC, 

TAPI SS TS DATA PACKET } 

enum TelSsUssdRespType t { TAPI USSD RES UNKNOWN ALPHABET, TAPI USSD - 
RES DISPL BUSY, ТАРІ USSD RES OK, ТАРІ USSD RES NONE } 

enum TelSsUssdIndType t ( 

ТАРІ USSD IND NOTIFY = 0x00, ТАРІ USSD IND NO ACTION REQUIRE = 0x01, ТАРІ - 
USSD IND. ACTION REQUIRE = 0x02, ТАРІ USSD IND TERMINATED BY NET = 0x03, 
ТАРІ USSD IND OTHER CLIENT = 0x04, ТАРІ USSD IND МОТ SUPPORT = 0x05, ТАРІ - 
USSD IND TIME OUT - 0x06 ] 

enum TelSsCallBarOperationMode t { TAPI SS CALL BAR ACTIVATE, TAPI SS CALL - 
ВАК DEACTIVATE } 

enum TelSsCallType t { 

TAPI CALL TYPE VOICE EV, TAPI CALL TYPE DATA EV, TAPI CALL TYPE FAX - 
EV, TAPI CALL TYPE SHORT MESS EV, 

ТАРІ CALL ТҮРЕ DATA CIRCUIT SYNC ЕУ) 

enum TelSsForwardMode t ( TAPI CALL FORWARD MODE DISABLE EV, TAPI CALL - 
FORWARD MODE ENABLE EV,  TAPI CALL FORWARD MODE REGISTRATION EV, 
TAPI CALL FORWARD MODE ERASURE EV } 

enum TelSsForwardType t { ТАРІ CS FORWARD ТҮРЕ VOICE EV = 0, ТАРІ CS - 
FORWARD TYPE DATA EV, ТАРІ CS FORWARD TYPE FAX ЕУ) 


enum  TelSsRestrictIDStatus t { ТАРІ CALL RESTRICT ID DEPEND NETWORK EV, 
ТАРІ CALL RESTRICT ID ENABLE EV, ТАРІ CALL RESTRICT ID DISABLE ЕУ) 


enum TelSsType t { 


TAPI 55 TYPE BARRING, TAPI 55 TYPE FORWARDING, ТАРІ 55 TYPE WAITING, 
TAPI SS TYPE IDENTIFICATION, 


ТАРІ 55 ТҮРЕ СМАР, TYPE SS TYPE USSD ) 
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enum TelSsCause t ( 


TAPI SS SUCCESS, TAPI SS TIMEREXPIRE, TAPI SS UNKNOWNSUBSCRIBER, TAPI - 
SS SERVICENOTPROVISIONED, 


TAPI SS CALLBARRED, TAPI SS ILLEGALSSOPERATION ERROR, TAPI SS - 
NOTAVAILABLE, ТАРІ 55 SUBSCRIPTIONVIOLATION, 


TAPI SS FACILITYNOTSUPPORTED, TAPI SS UNEXPECTEDDATAVALUE, ТАРІ SS - 
PWREGISTRATIONFAILURE, ТАРІ 55 NEGATIVEPWCHECK, 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION, TAPI SS UNKNOWNALPHABET, 
ТАРІ 55 USSDBUSY, ТАРІ 55 REJECTEDBYUSER, 


ТАРІ 55 REJECTEDBYNETWORK, ТАРІ SS INVALIDDEFLECTEDTONUMBER, ТАРІ - 
SS MAXNOMPTYEXCEEDED, TAPI SS RESOURCESNOTAVAILABLE, 


TAPI SS UNKNOWNERROR, TAPI SS OEM, NOT SUPPORTED } 
enum TelSsStatus t ( 


TAPI SS STATUS ACTIVE, TAPI SS STATUS REGISTERED, TAPI SS STATUS - 
PROVISIONED, TAPI SS STATUS QUIESCENT, 


TAPI SS STATUS NOTHING } 
enum TelSsLineldentificationType t { 


ТАРІ CALLING LINE IDENTITY PRESENTATION, ТАРІ CALLING LINE IDENTITY - 


RESTRICTION, TAPI CONNECTED LINE IDENTITY PRESENTATION, TAPI - 
CONNECTED LINE IDENTITY RESTRICTION, 

TAPI CALLED LINE IDENTITY PRESENTATION, ТАРІ CALLING. NAME - 
PRESENTATION } 


enum TelSsCliStatus t { 


TAPI CLI STATUS NOT PROVISONED, TAPI CLI STATUS PROVISIONED, TAPI CLI - 
STATUS ACTIVATED, TAPI CLI STATUS UNKOWN, 
TAPI CLI STATUS TEMP RESTRICTED, TAPI CLI STATUS TEMP ALLOWED ] 


enum TelSsBarPwdType t { TAPI SS ВАК GET PWD, TAPI SS BAR NEW PWD, TAPI - 
SS ВАК VERIFY NEW PWD] 
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7.13  TelUtility.h File Reference 


7.13.1 Detailed Description 


This file serves as a "C" header file defines structures for Utility Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelTapiVersionInfo t 
* struct TelTapiTunnelInfo t 
* struct TelTapiErrorInfo t 


Enumerations 


* enum TapiResult t { 


TAPI API SUCCESS, TAPI API INVALID INPUT, TAPI API INVALID PTR, TAPI API - 
INVALID САШ, STATE, 


TAPI API NOT SUPPORTED, ТАРІ АРІ DEPRICATED, ТАРІ АРІ SYSTEM OUT OF - 
MEM, ТАРІ АРІ SYSTEM RPC LINK. DOWN, 


ТАРІ АРІ MODEM POWERED OFF, ТАРІ АРІ SERVICE NOT READY, ТАРІ АРІ - 
SERVER FAILURE, ТАРІ АРІ ОЕМ PLUGIN FAILURE, 


TAPI API INVALID CALL HANDLE, TAPI API INVALID DATA LEN, TAPI API SIM - 
NOT FOUND, TAPI API SIM BUSY, 


TAPI API SIM INVALID CARD TYPE, TAPI API SIM CARD PERMANENT ERROR, 
TAPI API SIM NOT INITIALIZED, TAPI API REQUEST MAX IN PROGRESS, 


TAPI API OFFLINE MODE ERROR, TAPI EVENT CLASS UNKNOWN, TAPI EVENT - 
UNKNOWN, TAPI REGISTRATION FAILURE } 
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